> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/google-news/headlines>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/google-news/headlines.mdx>

---

# Google News Headlines API

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

`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`.

## Request

- **Endpoint:** `GET /v1/google-news/headlines`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by edition
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/google-news/headlines/get)
- **Platform page:** [/platforms/google-news](https://www.socialfetch.dev/platforms/google-news)

## 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.