Skip to main content
GOOGLE_NEWS returns the articles Google lists in its News tab for a search. It reads up to ten pages of about 10 articles and keeps Google’s order across pages, so you can follow which publishers Google shows for a topic, a brand or a competitor, and how that changes over time.

Request

This request asks for the first two News pages for electric vehicle tariffs in the US:
The task runs asynchronously. Read the result as described in Async tasks.

Parameters

Response

For example, the request above:
When Google’s list ends before pages, newsResults holds every article Google listed and pages counts the pages read. Treat every field except position, title, link and page as optional.

Credits

Each News page read costs 1 credit. When it starts, the task holds the credits for the pages you asked for: 1 for the default, 10 for pages: 10. On completion it is charged for the pages it read, so a list Google ends after three pages costs 3. A failed task costs 0. See Credits and limits.

Limits and errors

  • An empty newsResults in a completed task means Google listed no article for the search. It is confirmed on a second browser before it is returned, and costs 1 credit.
  • An hl that is not a language code such as en, de or pt-BR returns 422 VALIDATION_ERROR.
  • pages outside 1-10 or a device other than desktop, mobile or android returns 422 VALIDATION_ERROR.
  • state and uule return 422 LOCATION_UNSUPPORTED. Set the market with country.
  • include.rawResponse has no effect, and include.html and include.analysis return 422. See Markdown and raw responses.
  • Other request errors are listed in Errors.