Article Search

GET {{baseURL}}/svc/search/v2/articlesearch.json?fq=romney&page=1&facet_field=day_of_week&facet=true&begin_date=20120101&end_date=20120101

Request Params

KeyDatatypeRequiredDescription
qnullQuery
fqstringFilter query: use filters to narrow the scope of your search.

You can specify the fields and the values that your query will be filtered on.

The Article Search API uses Elasticsearch, so the filter query (fq) uses standard Lucene syntax. Separate the filter field name and value with a colon, and surround multiple values with parentheses.

field-name:("value1", "value2", ... "value n")

The default connector for values in parentheses is OR. If you declare an explicit boolean value, it must be capitalized. You can filter on multiple values and fields.

field-name-1:("value1") AND field-name-2:("value2", "value3")

  • For a list of all fields you can filter on, see the Filter Query Fields table.
  • You can also filter by search text. | | page | number | | Page number (0, 1, ...) | | facet_field | string | | Facets

Use facets to view the relative importance of certain fields to a search term, and gain insight about how to best refine your queries and filter your search results.

The following fields can be used as facet fields: day_of_week, document_type, ingredients, news_desk, pub_month, pub_year, section_name, source, subsection_name, and type_of_material. | | facet | boolean | | Whether to show facet counts | | facet_filter | null | | Have facet counts use filters | | fl | null | | Field list | | begin_date | number | | Begin date (e.g. 20120101) | | end_date | number | | End date (e.g. 20121231) | | sort | null | | Sort order |