Monitor Google News Results
Google News
Extract Google News
Extract structured news articles from Google News including titles, links, snippets, sources, dates, and thumbnails
POST
Monitor Google News Results
Overview
The Google News endpoint extracts structured news articles from Google News, including titles, links, snippets, sources, publication dates, and thumbnail images.Request parameters
Required parameters:query(string): The search query to execute on Google News (1-10,000 characters)
country(string): ISO 3166-1 alpha-2 country code for localized news results. Defaults toUSdevice(string): Device type for news results. Options:desktop(default),mobilepages(integer): Number of news results pages to scrape (1-10). Defaults to1include.html(boolean): Include raw HTML response. Defaults tofalse
Response schema
Includes common response fields plus:Google News results
| Field | Type | Description |
|---|---|---|
result.newsResults | array | News articles from Google News |
result.html | array | Raw HTML response (if requested) |
Response objects
The response includes the following sections. See each subpage for the full schema.| Section | Description |
|---|---|
| News articles | Article titles, links, snippets, sources, publication dates, and thumbnails |
Usage examples
Basic news search
Multi-page news search
Scrape multiple pages of news results:Mobile news results
Get news results optimized for mobile devices:Include HTML response
Request raw HTML alongside structured data:Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Request parameters for monitoring Google News results
The search query to execute on Google News
Required string length:
1 - 10000Example:
"climate change"
ISO 3166-1 alpha-2 country code for localized news results
Example:
"US"
Device type for news results
Available options:
desktop, mobile Example:
"desktop"
Number of news results pages to scrape (1-10)
Required range:
1 <= x <= 10Example:
1
Optional flags for including additional response data