Skip to main content
POST /v1/data/google/news/run Pricing: $0.002 per new ($2.00 per 1,000).

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string
required
What to search for in Google News.
integer
Number of news articles to return. Use 0 for all.
string
default:"7d"
How far back to look. Leave blank for no limit.Allowed values: 1h (Past hour), 1d (Past day), 7d (Past week), 1y (Past year), all (All time).
string
default:"US:en"
Country market and article language. The two go together (Google News only supports these specific combinations). Defaults to US English.84 allowed values, for example US:en (United States - English), GB:en (United Kingdom - English), AU:en (Australia - English), CA:en (Canada - English), IN:en (India - English), IE:en (Ireland - English), NZ:en (New Zealand - English), SG:en (Singapore - English), ZA:en (South Africa - English), PH:en (Philippines - English). Fetch the full list with GET /v1/data/google/news?expand=options.

Example

Response fields

Each row in data is one new, keyed by these fields.

Example response

Abridged: long text and lists are shortened.