Social Fetch
Start for freeStart free
Google News hub

Google News Headlines API

The edition's headlines grouped by section, ready to render as a news front page.

GET /v1/google-news/headlines

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/google-news/headlines returns edition and groups. Each group has a name in the edition's language, such as U.S. or World, and an articles array. Every article is the standard record with id, title, publishedAt, url, ampUrl, image, source, authors, label and storyId where the article has it.

One answer holds at most 50 groups and 200 articles, in Google News order. There is no page parameter. Use language and country to choose the edition; the resolved pair is in edition. For a flat list of story clusters instead of section groups, use GET /v1/google-news/top-stories.

Google News Headlines API FAQ

How are the headlines grouped?

Each entry in groups is one Google News section, with its name and its articles. Group order follows the edition, not the article time.

Can I get only one section?

Not with this route; it returns every group in the answer. Read the group whose name matches the section you want, or resolve the section id and use the topic route.

Why are there fewer than 200 articles?

The route caps the answer at 50 groups and 200 articles, and some editions carry fewer sections. The cap is a limit, not a page: there is no cursor.

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