Google news search

Returns up to 100 articles with headline, publisher and publisher domain, publication timestamp and the Google News link. query accepts Google's operators directly ("exact phrase", OR, -word, intitle:), and the structured filters below compose with whatever you write.

One call is one page, and there is no second: Google caps a feed at 100 and ignores every paging parameter. truncated tells you when you hit that cap, narrow with after/before, which is the only thing that pages this surface, or use /google-news-brand-mentions-v4, which does the fanning for you.

There are no thumbnails, snippets or article bodies on any Google News feed, Google ships none of them, so those fields are absent rather than faked.

The example response below is real output from this endpoint, not an illustration. Long lists and long strings are shortened to keep the page readable, and each place that happens is marked. This example took 3.0s.

Authorization

ApiKeyAuth

X-API-Key<token>

Your API key. Sent on every request.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

query*string

Search terms; Google News operators such as "exact phrase", OR, -exclude and intitle: work as written

after?string

Only articles published on/after this ISO date (YYYY-MM-DD)

before?string

Only articles published on/before this ISO date (YYYY-MM-DD)

country?string

ISO-2 edition country, e.g. US, GB, IN, JP. Defaults to US. Changes which outlets are indexed and how stories rank.

exclude_sites?array<string>

Drop these publisher domains (subdomains included), e.g. Your own newsroom. Applied to the returned feed, not sent as Google's -site: operator, that operator does not exclude anything and silently swaps Google's ranked news index for an unranked pool of content farms. So exclusion lowers returned rather than making room for more articles; excluded reports how many were dropped.

language?string

Edition language, e.g. En, de, hi. Defaults to the country's default edition.

resolve_urls?boolean

Also resolve each article's real publisher URL. Costs one ~120KB page fetch per NEW article (~100x the feed row), so it is off by default; resolutions are cached permanently and reused free on later requests.

Defaultfalse

sites?array<string>

Restrict to these publisher domains, e.g. ['reuters.com']

when?string

Relative window: a number plus h, d or y, e.g. 12h, 7d, 1y. Google has NO month unit; 'when:1m' silently returns nothing, so use 30d.

Response Body

`application/json`

curl -X POST "https://example.com/v1/scrapers/google-news-search-v4" \  -H "Content-Type: application/json" \  -d '{    "query": "Nike",    "when": "2d",    "language": "en",    "country": "US"  }'

{  "request_id": "req_8f2c1d94e7b0",  "success": true,  "status": {    "code": "OK",    "message": "Scrape completed.",    "retryable": false  },  "data": {    "articles": [      {        "google_news_url": "https://news.google.com/rss/articles/CBMiywFBVV95cUxQVTRJZEVYMWJ5Y25leXNOMXdYTDRVTDVVZTRTSHVxOFIyMnNocjR3b1BUQV9hRHpFQWVYN29FeVJPT3N6RHRmUkRyanA2MDJWNHc0WkVCcVVPRnpIQTZTNzlpTEZBaEVCcTBtaW9pM0Jyek5QbmcwU0gya0htUHk0UmxMM1RMUlUyQ1ktdVJ6aEx6RUJDdl81NW9CRzJia1JBUmtpbTNocko2TU1MSzhOQm5OUS1NbkJ3YU9KSk55R1Z3aWZqSlRHYV9GYw",        "id": "CBMiywFBVV95cUxQVTRJZEVYMWJ5Y25leXNOMXdYTDRVTDVVZTRTSHVxOFIyMnNocjR3b1BUQV9hRHpFQWVYN29FeVJPT3N6RHRmUkRyanA2MDJWNHc0WkVCcVVPRnpIQTZTNzlpTEZBaEVCcTBtaW9pM0Jyek5QbmcwU0gya0htUHk0UmxMM1RMUlUyQ1ktdVJ6aEx6RUJDdl81NW9CRzJia1JBUmtpbTNocko2TU1MSzhOQm5OUS1NbkJ3YU9KSk55R1Z3aWZqSlRHYV9GYw",        "published_at": "2026-08-23T10:30:00Z",        "publisher": "About Nike",        "publisher_domain": "about.nike.com",        "publisher_url": "https://about.nike.com",        "title": "Nike’s One Piece Collection Transforms Imagination Into Motion for Adventurers Everywhere"      },      {        "google_news_url": "https://news.google.com/rss/articles/CBMi-gFBVV95cUxNalBDR3F1ZWRjV0lMQlVzV3BCaHhmS0pIdXZtZWUxZVVTVzZwMDJHT2lEZTBpNjZBZWhJSE9aZG1UUEdWX09pYTBmMjFoamllbW45b3dySkp3em92b3NqOXJ2NE5jQ2ZlQTlMcHc3OEZ0UFJHQ04tMXhyclJqODFhVF9ZaU9MMEkxZjJPdmJJdEZXWnFjaEMtRlZOQXcwZ0Q0V0ExcTJ4bW1POXFhdnRfT3JWT0lXZ0c1d0xoVW5KTkoxOGt6ZzJZS2d1aWtfaEt… (+57 chars)",        "id": "CBMi-gFBVV95cUxNalBDR3F1ZWRjV0lMQlVzV3BCaHhmS0pIdXZtZWUxZVVTVzZwMDJHT2lEZTBpNjZBZWhJSE9aZG1UUEdWX09pYTBmMjFoamllbW45b3dySkp3em92b3NqOXJ2NE5jQ2ZlQTlMcHc3OEZ0UFJHQ04tMXhyclJqODFhVF9ZaU9MMEkxZjJPdmJJdEZXWnFjaEMtRlZOQXcwZ0Q0V0ExcTJ4bW1POXFhdnRfT3JWT0lXZ0c1d0xoVW5KTkoxOGt6ZzJZS2d1aWtfaEt4N2l0NVEwMjhmU3FpZXpDNmpETk0xbEdfRFdU… (+20 chars)",        "published_at": "2026-08-23T07:48:44Z",        "publisher": "Stocktwits",        "publisher_domain": "stocktwits.com",        "publisher_url": "https://stocktwits.com",        "title": "NKE Stock In Focus: $10K Invested In Nike A Decade Ago Would Have Lost Money Despite Pandemic-Era Surge"      },      "… 98 more items in the full response"    ],    "country": "US",    "edition": "US:en",    "language": "en",    "query": "Nike",    "resolved_query": "Nike when:2d",    "returned": 100,    "truncated": true  },  "error": null,  "meta": {    "client_id": "client_abc123",    "scraper": "google-news-search-v4",    "billable": true,    "duration_ms": 2121  }}

Authorization

Request Body

Response Body

200application/json

404application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`