Social Fetch
Start for freeStart free
Google News hub

Google News Full Coverage API

One story with the articles different outlets published about it, newest coverage included.

GET /v1/google-news/stories/{storyId}

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/google-news/stories/{storyId} returns lookupStatus, story and edition. story has the story id, its title and articles. Each article is the standard record with url, ampUrl, image, source, authors, label and publishedAt when the record carries them.

A live story holds 6 to 58 articles and the answer returns at most 200. There is no page parameter. Take the storyId from an article record, or use source.publicationId with the publisher route when you want one outlet's coverage instead of the story's spread.

An expired or unknown story returns lookupStatus: not_found with story: null. A blank story can return title: null, so check the fields inside story rather than only the status.

Google News Full Coverage API FAQ

Where does the story id come from?

From storyId on an article record. It is the Full Coverage id, not the article id.

Why is the story not_found?

The story has expired or the id does not exist. Full Coverage pages are not kept forever, so an old id can stop resolving.

How many articles are in a story?

A live story usually holds 6 to 58 articles. The route returns at most 200.

How many credits does it cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.

Other Google News endpoints