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

---

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

## Request

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

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