Skip to main content
POST
Monitor Google News Results
Extract structured news articles from Google News: 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 (uppercase) for localized news results. Required — there is no default
Optional parameters:
  • device (string): Device the search is run from. Options: desktop (default), ios, android, and mobile (an alias for android). ios emulates Safari on iPhone and android emulates Chrome on Android; all three phone values return the mobile news SERP layout
  • pages (integer): Number of news results pages to scrape (1-10). Defaults to 1
  • include.html (boolean): Include raw HTML response. Defaults to false

Response schema

Includes common response fields plus:

Google News results

Response objects

Usage examples

Articles from all 3 pages are combined into a single response.

Mobile news results

The mobile news SERP as seen from an iPhone. Use "device": "android" for Chrome on Android instead:

Include HTML response

Raw HTML alongside the structured data:

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Request parameters for monitoring Google News results

query
string
required

The search query to execute on Google News

Required string length: 1 - 10000
Example:

"climate change"

country
string
required

ISO 3166-1 alpha-2 country code for localized news results

Example:

"US"

device
enum<string>
default:desktop

Device the search is run from. 'desktop' returns the desktop news SERP; 'ios' (Safari on iPhone), 'android' (Chrome on Android) and 'mobile' (alias for 'android') all return the mobile news SERP.

Available options:
desktop,
mobile,
ios,
android
Example:

"desktop"

pages
integer
default:1

Number of news results pages to scrape (1-10)

Required range: 1 <= x <= 10
Example:

1

include
object

Optional flags for including additional response data

Response

successful Google News monitoring response

success
boolean
required
Example:

true

result
object
required

Google News results data