Search Google News
Search Google News by words, operators, edition and time window, and follow the cursor into older windows.
Headers
Get your API keyAPI key (`sfk_...`)
Search words. Google News operators work inside it: `site:`, `intitle:`, `source:`, quotes, `OR`, `-term`. `when:`, `after:` and `before:` are set by the dedicated parameters. Control characters are removed.
min 1 chars · max 2000 chars
Language and locale of the edition, e.g. `en-US`, `de`, `pt-BR` or `zh-Hant`. Default: `en-US`. The 400 response for an unsupported pair lists every supported pair.
min 2 chars · max 16 chars
Two-letter country of the edition, e.g. `US`, `GB` or `JP`. Default: `US`. Send it with `language`; an unsupported pair is rejected with every supported pair listed.
min 2 chars · max 2 chars
`page.nextCursor` from the previous response. It continues the same query and edition one day at a time; do not send `when`, `after` or `before` with it.
min 1 chars · max 16384 chars
Only articles from this recent window, e.g. `1h`, `7d`, `1y`.
pattern: ^[1-9][0-9]{0,3}[hdy]$
Only articles after this date, `YYYY-MM-DD`.
pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$
Only articles before this date, `YYYY-MM-DD`.
pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$
Endpoint-specific response payload.
The search expression this page used: the request `query` plus any `when:`, `after:` or `before:` window, e.g. `openai when:1h`.
Title of the result set; it contains the expression this page used, e.g. `"openai when:1h" - Google News`.
The edition of this result.
Language and locale of the edition, e.g. `en-US`.
Two-letter country of the edition, e.g. `US`.
Articles, in Google News order.
Article id; the same id on every route.
Headline as the record gives it; a trailing outlet suffix is removed when present.
Publication time in UTC, when the record gives one.
`day` when the record only gives a date: midnight Pacific in the `en-US` edition. `second` otherwise.
one of: second, day
Google News link; null on topic, story, publisher and headline results.
Publisher article URL. Null on search and top-stories results; use `articles/resolve` to get it.
AMP form of the publisher URL.
Article image, or null when the record has none.
The publisher's own image URL.
Image width in pixels.
Image height in pixels.
The outlet an article is from.
Publisher name, e.g. `Reuters`.
Publisher root URL, when the record gives one.
Stable publisher id from an article record; the input for the publisher endpoint.
Publisher favicon URL.
Authors of the article.
Author name as Google News displays it.
Author topic id, when the author has one.
Article label, e.g. `Opinion`, in the edition's language.
Full Coverage story id, the input for the story endpoint.
Short headline of the story cluster, when the record carries one.
Other outlets in the same story cluster. Empty on topic, story, publisher and headline results.
Article id.
Headline as the record gives it; a trailing outlet suffix is removed when present.
Working Google News link for the article.
The outlet an article is from.
Publisher name, e.g. `Reuters`.
Publisher root URL, when the record gives one.
Stable publisher id from an article record; the input for the publisher endpoint.
Publisher favicon URL.
Paging state of a list.
Whether another older window can be requested.
The next window's exclusive `before:` date, `YYYY-MM-DD`; null on the last page.
Opaque cursor for the next older day window; null on the last page.
`true` when this page's window reached the 100-item limit, so a busier window is cut short; `false` on the ranked first page when no window was given and on windows under the ceiling.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/google-news/search?query=openai" \
-H "x-api-key: YOUR_API_KEY"Responses
A page of search results.