List Google News publisher articles
List Google News publisher articles with publisher URLs, images, authors and labels.
Headers
Get your API keyAPI key (`sfk_...`)
Google News publication id, from the `topics/resolve` endpoint or an article record's `source.publicationId`.
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
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 publisher 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`.
Recent articles, with publisher URLs, images and authors.
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 publisher stream; null on `not_found`. `unavailable` means the outlet exists but its stream is not available in this edition: pass the outlet's own language and country. `empty` means the outlet has no articles in this edition right now.
one of: live, empty, unreadable, unavailable, null
The edition of this result.
Language and locale of the edition, e.g. `en-US`.
Two-letter country of the edition, e.g. `US`.
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/publishers/CAAqJQgKIh9DQklTRVFnTWFnMEtDM0psZFhSbGNuTXVZMjl0S0FBUAE" \
-H "x-api-key: YOUR_API_KEY"Responses
A publisher's recent articles.