Social Fetch
Start for freeStart free
Google News hub

Google News Home API

The edition's home briefing and navigation in one answer, so you can reproduce the front page.

GET /v1/google-news/home

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/google-news/home returns edition, briefing, sections and articles. briefing has the title and date line of the briefing, in the edition's language. sections is the navigation list with each section's id and name. articles is the briefing list with the standard article fields, including url, image, source, authors and storyId when the record carries them.

The briefing usually holds about 13 articles and the answer returns at most 50. There is no page parameter. Use language and country to choose the edition; the resolved pair is in edition. For a flat set of top-story clusters, use GET /v1/google-news/top-stories.

Google News Home API FAQ

What is the briefing?

It is the editorial block at the top of the edition's home page: a title, a date line and a short list of articles. briefing.title and briefing.date are null when the briefing has none.

How do I use the sections?

Each entry has the section id and name. Pass the id to GET /v1/google-news/topics/{topicId} to get that section's stream, or use GET /v1/google-news/sections when you only need the navigation list.

How many articles are returned?

The briefing usually has about 13 articles, and the route returns at most 50. It is one page, not a paged list.

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