Prepend words or phrases that must appear with a + symbol. Eg: +bitcoin
Prepend words that must not appear with a - symbol. Eg: -bitcoin
Alternatively you can use the AND / OR / NOT keywords, and optionally group these with parenthesis. Eg: crypto AND (ethereum OR litecoin) NOT bitcoin.
The complete value for q must be URL-encoded.
A comma-seperated string of identifiers (maximum 20) for the news sources or blogs you want headlines from. Use the /sources endpoint to locate these programmatically or look at the sources index.
A comma-seperated string of domains (eg bbc.co.uk, techcrunch.com, engadget.com) to restrict the search to.
A comma-seperated string of domains (eg bbc.co.uk, techcrunch.com, engadget.com) to remove from the results.
A date and optional time for the oldest article allowed. This should be in ISO 8601 format (e.g. 2019-02-21 or 2019-02-21T02:29:30) Default: the oldest according to your plan.
A date and optional time for the newest article allowed. This should be in ISO 8601 format (e.g. 2019-02-21 or 2019-02-21T02:29:30) Default: the newest according to your plan.
The 2-letter ISO-639-1 code of the language you want to get headlines for. Possible options: ardeenesfrheitnlnoptruseudzh . Default: all languages returned.
The order to sort the articles in. Possible options: relevancy, popularity, publishedAt. relevancy = articles more closely related to q come first. popularity = articles from popular sources and publishers come first. publishedAt = newest articles come first. Default: publishedAt
The number of results to return per page. 20 is the default, 100 is the maximum.
Use this to page through the results.
Your API key. Alternatively you can provide this via the X-Api-Key HTTP header.
If the request was successful or not. Options: ok, error. In the case of error a code and message property will be populated.
The total number of results available for your request. Only a limited number are shown at a time though, so use the page parameter in your requests to page through them.
The results of the request.
The identifier id and a display name name for the source this article came from.
The author of the article
The headline or title of the article.
A description or snippet from the article.
The direct URL to the article.
The URL to a relevant image for the article.
The date and time that the article was published, in UTC (+000)
The unformatted content of the article, where available. This is truncated to 260 chars for Developer plan users.