List Google News headlines by section
List Google News headlines grouped by section for an edition, with publisher URLs.
Headers
Get your API keyAPI key (`sfk_...`)
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
Endpoint-specific response payload.
The edition of this result.
Language and locale of the edition, e.g. `en-US`.
Two-letter country of the edition, e.g. `US`.
Headline groups, in Google News order. At most 50 groups and 200 articles are returned.
Group name in the edition's language, e.g. `U.S.`.
Articles in this group, with publisher URLs.
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.
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/headlines?language=en-US&country=US" \
-H "x-api-key: YOUR_API_KEY"Responses
Headlines grouped by section.