To use this endpoint you will need the following reference data:
The maximum range between the
todates in your query should not exceed 7 days.
For historical reasons, the queryable fields
summarydiffer in naming from their
The following filtering options can be used in the
filters body parameter.
|Two letter (lower case) ISO 3166 country code.
|Available regions (lower case):
na North America
sea South East Asia
sa South America
me Middle East
|Supported languages are listed in Supported Languages.
|Supported categories are listed in Topics.
|TLD such as
|Exact domain where the article was published. e.g.
|The possible permutations of publisher and subdomains. See this section of the data dictionary for an explanation of the difference between
|Search by the full url of the article eg.
|Handy for articles that follows a particular path on a site, e.g: to look for all articles with url follows
"http://www.complex.com/tag/politics", use filter with
publisher:complex.com AND siteStructure:\\/tags\\/politics or publisher:complex.com AND siteStructure:"/tags/politics" will be sufficient.
Sorts one of the following in descending order:
nw_max_score when the selected time range is <= 25h, otherwise it will be
content_type is set to
youtube, the default sort order is by
created_at. You can also sort in descending order by