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

---

# Google Trends Headlines API

The fixed ten-item trending list for a place, with volume, time, a picture and the stories behind each trend.

`GET /v1/google-trends/trending/headlines` returns the headline list for a place. The only parameter is `geo`, a country or subdivision code such as `US`, `GB` or `DE-BY`. The list is fixed at ten items, so `data.limit` is always 10 and there is no paging parameter.

On `found`, each item in `data.trends[]` has `query`, `searchVolume.label` and `searchVolume.min` (for example `2000+` and 2000), `startedAt` in ISO 8601 UTC, an `image` with `url` and `source`, and `news[]` with up to three items, each with `title`, `url`, `source` and an optional `image`. An empty list is still `found` with no rows. A geo Google Trends does not serve is a 400 with an input message, not a not-found.

## Request

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

## FAQ

### Why only ten items?

The list carries ten. There is no parameter for more, so data.limit is always 10. Use GET /v1/google-trends/trending when you need a longer list with a cursor.

### What is in each news item?

news[] holds up to three records with title, url and source. image is the story thumbnail, or null when it repeats the trend's own picture.

### What does an empty list mean?

The answer is lookupStatus found with an empty trends array. A quiet place can have no headlines, which is different from a geo Google Trends refuses.

### What happens with an unsupported geo?

The route answers 400 and the request is not billed. GET /v1/google-trends/trending also refuses a place it does not serve with a 400.

### How much does a headline lookup 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.