Social Fetch
Start for freeStart free
Google News hub

Google News Top Stories API

The edition's top-story clusters, each with the other outlets covering the same story.

GET /v1/google-news/top-stories

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/google-news/top-stories returns title, edition and articles. Each lead article is a story cluster: it carries id, title, publishedAt, source and up to four more outlets in relatedArticles. Each related item has its own id, title, googleUrl and source.

One call usually holds about 26 to 38 clusters and the answer returns at most 100. There is no page parameter, so one call is the current top-stories set for the edition. Use language and country to pick the edition; the resolved pair is in edition.

For a topic rather than the front page, resolve the topic id and call GET /v1/google-news/topics/{topicId}. For a full list grouped by section, use GET /v1/google-news/headlines.

Google News Top Stories API FAQ

What is a cluster?

A cluster is one top story with its lead article in articles and the other outlets covering it in relatedArticles. The lead is a normal article record, so it has the same fields as every other article.

Why are there several outlets in one item?

relatedArticles holds the other outlets in the same cluster, up to four. Each related item has id, title, googleUrl and source, which is enough to deduplicate coverage before requesting a topic or story.

How do I get a different edition?

Send a supported language and country pair, for example en-GB and GB or ja and JP. The answer reports the pair it used in edition.

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