> **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/top-stories>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/google-news/top-stories.mdx>

---

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

## Request

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

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