Google News

Get Google News Full Coverage story

Get Google News Full Coverage story and articles from different outlets.

GET/v1/google-news/stories/{storyId}
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
storyIdstringrequiredpath

Google News Full Coverage story id, e.g. `CAAqNggKIjBDQklTSG...`.

min 20 chars · max 2048 chars · pattern: ^[A-Za-z0-9_-]+$

languagestringoptionalquery

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

countrystringoptionalquery

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

Response fields
44

Endpoint-specific response payload.

datalookupStatus
string

`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 story; null when it has expired or does not exist.

datastoryid
string

Story id.

datastorytitle
stringnullable

Story title, e.g. `News about Oklahoma`; null when the story has none.

Articles in the Full Coverage list, with their publisher URLs.

datastoryarticles[]id
string

Article id; the same id on every route.

datastoryarticles[]title
string

Headline as the record gives it; a trailing outlet suffix is removed when present.

datastoryarticles[]publishedAt
stringnullable

Publication time in UTC, when the record gives one.

datastoryarticles[]datePrecision
string

`day` when the record only gives a date: midnight Pacific in the `en-US` edition. `second` otherwise.

one of: second, day

datastoryarticles[]googleUrl
stringnullable

Google News link; null on topic, story, publisher and headline results.

datastoryarticles[]url
stringnullable

Publisher article URL. Null on search and top-stories results; use `articles/resolve` to get it.

datastoryarticles[]ampUrl
stringnullable

AMP form of the publisher URL.

Article image, or null when the record has none.

datastoryarticles[]imageurl
stringnullable

The publisher's own image URL.

datastoryarticles[]imagewidth
integernullable

Image width in pixels.

datastoryarticles[]imageheight
integernullable

Image height in pixels.

The outlet an article is from.

datastoryarticles[]sourcename
stringnullable

Publisher name, e.g. `Reuters`.

datastoryarticles[]sourceurl
stringnullable

Publisher root URL, when the record gives one.

datastoryarticles[]sourcepublicationId
stringnullable

Stable publisher id from an article record; the input for the publisher endpoint.

datastoryarticles[]sourceiconUrl
stringnullable

Publisher favicon URL.

Authors of the article.

datastoryarticles[]authors[]name
string

Author name as Google News displays it.

datastoryarticles[]authors[]topicId
stringnullable

Author topic id, when the author has one.

datastoryarticles[]label
stringnullable

Article label, e.g. `Opinion`, in the edition's language.

datastoryarticles[]storyId
stringnullable

Full Coverage story id, the input for the story endpoint.

datastoryarticles[]clusterHeadline
stringnullable

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.

datastoryarticles[]relatedArticles[]id
string

Article id.

datastoryarticles[]relatedArticles[]title
string

Headline as the record gives it; a trailing outlet suffix is removed when present.

datastoryarticles[]relatedArticles[]googleUrl
string

Working Google News link for the article.

The outlet an article is from.

datastoryarticles[]relatedArticles[]sourcename
stringnullable

Publisher name, e.g. `Reuters`.

datastoryarticles[]relatedArticles[]sourceurl
stringnullable

Publisher root URL, when the record gives one.

datastoryarticles[]relatedArticles[]sourcepublicationId
stringnullable

Stable publisher id from an article record; the input for the publisher endpoint.

datastoryarticles[]relatedArticles[]sourceiconUrl
stringnullable

Publisher favicon URL.

The edition of this result.

dataeditionlanguage
string

Language and locale of the edition, e.g. `en-US`.

dataeditioncountry
string

Two-letter country of the edition, e.g. `US`.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/google-news/stories/CAAqNggKIjBDQklTSGpvSmMzUnZjbmt0TXpZd1NoRUtEd2ktbmFDbUVoSGxXMm5nd1dFN2ZDZ0FQAQ" \
  -H "x-api-key: YOUR_API_KEY"

Responses

A Full Coverage story and its articles.