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: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 forpages: 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
newsResultsin 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
hlthat is not a language code such asen,deorpt-BRreturns422 VALIDATION_ERROR. pagesoutside 1-10 or adeviceother thandesktop,mobileorandroidreturns422 VALIDATION_ERROR.stateanduulereturn422 LOCATION_UNSUPPORTED. Set the market withcountry.include.rawResponsehas no effect, andinclude.htmlandinclude.analysisreturn422. See Markdown and raw responses.- Other request errors are listed in Errors.
Related
- Google Search for one results page with its organic results
- Resolve a Google redirect
- Credits and limits