Everything /v2/everything

Search through millions of articles from over 80,000 large and small news sources and blogs.

This endpoint suits article discovery and analysis.

Request parameters

  • apiKey required

    Your API key. Alternatively you can provide this via the X-Api-Key HTTP header.

  • q

    Keywords or phrases to search for in the article title and body.

    Advanced search is supported here:

    • Surround phrases with quotes (") for exact match.
    • 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. Max length: 500 chars.

  • qInTitle

    Keywords or phrases to search for in the article title only.

    Advanced search is supported here:

    • Surround phrases with quotes (") for exact match.
    • 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 qInTitle must be URL-encoded. Max length: 500 chars.

  • sources

    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.

  • domains

    A comma-seperated string of domains (eg bbc.co.uk, techcrunch.com, engadget.com) to restrict the search to.

  • excludeDomains

    A comma-seperated string of domains (eg bbc.co.uk, techcrunch.com, engadget.com) to remove from the results.

  • from

    A date and optional time for the oldest article allowed. This should be in ISO 8601 format (e.g. 2021-10-24 or 2021-10-24T22:51:16)

    Default: the oldest according to your plan.

  • to

    A date and optional time for the newest article allowed. This should be in ISO 8601 format (e.g. 2021-10-24 or 2021-10-24T22:51:16)

    Default: the newest according to your plan.

  • language

    The 2-letter ISO-639-1 code of the language you want to get headlines for. Possible options: ardeenesfrheitnlnoptruseudzh.

    Default: all languages returned.

  • sortBy

    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

  • pageSize int

    The number of results to return per page.

    Default: 100. Maximum: 100.

  • page int

    Use this to page through the results.

    Default: 1.

Response object

  • status string

    If the request was successful or not. Options: ok, error. In the case of error a code and message property will be populated.

  • totalResults int

    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.

  • articles array[article]

    The results of the request.

    • source object

      The identifier id and a display name name for the source this article came from.

    • author string

      The author of the article

    • title string

      The headline or title of the article.

    • description string

      A description or snippet from the article.

    • url string

      The direct URL to the article.

    • urlToImage string

      The URL to a relevant image for the article.

    • publishedAt string

      The date and time that the article was published, in UTC (+000)

    • content string

      The unformatted content of the article, where available. This is truncated to 200 chars.


Live examples
All articles about Bitcoin
Definition
GET https://newsapi.org/v2/everything?q=bitcoin&apiKey=API_KEY
Example response

All articles mentioning Apple from yesterday, sorted by popular publishers first
Definition
GET https://newsapi.org/v2/everything?q=apple&from=2021-10-23&to=2021-10-23&sortBy=popularity&apiKey=API_KEY
Example response

All articles published by TechCrunch and The Next Web
Definition
GET https://newsapi.org/v2/everything?domains=techcrunch.com,thenextweb.com&apiKey=API_KEY
Example response

Error example
Definition
GET https://newsapi.org/v2/everything
Example response