List Google News topic articles
List Google News topic, tab or publisher articles with publisher URLs, images, authors and Full Coverage story ids.
Headers
Get your API keyAPI key (`sfk_...`)
Google News topic id, from the `topics/resolve` endpoint, a section id or an article record.
min 10 chars · max 2048 chars · pattern: ^[A-Za-z0-9_-]+$
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
Sub-tab id from `topic.tabs[].id` (for example Sports' NFL tab). Without it the topic's latest stream is returned.
min 4 chars · max 2048 chars
Endpoint-specific response payload.
`found` when the entity exists, including when it has no articles right now. `not_found` when the id does not exist.
one of: found, not_found
The topic record; null when the id does not exist.
Topic, tab or publication id.
Topic name. Null when there is none (a publisher stream).
The topic's sub-tabs.
Tab id, for the topic endpoint's `tab` parameter.
Tab name as Google News displays it, e.g. `Latest` or `NFL`.
Articles with the publisher URL, image, authors, label, story id and cluster headline when the record carries them.
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.
Visible state of the stream; null on `not_found`. Use `empty` or `unavailable` to tell a real empty topic from a stream that is temporarily unavailable.
one of: live, empty, unreadable, unavailable, null
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/topics/CAAqJggKIiBDQkFTRWdvSUwyMHZNRGx1YlY4U0FtVnVHZ0pWVXlnQVAB" \
-H "x-api-key: YOUR_API_KEY"Responses
Articles for a topic, tab or publisher id.