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

---

# Google Trends Suggestions API

Send text, get up to five topics with the Knowledge Graph id that makes a term an exact topic.

`GET /v1/google-trends/suggestions` takes `query`, 1 to 120 characters, and an optional `language` such as `en-US`, `de` or `ja`. It returns at most five topics, so `data.limit` is always 5. Each item in `data.topics[]` has an `id` such as `/m/02vqfm`, a `title` and a free-text `type` in the interface language.

The id is the useful part: send `id:/m/02vqfm` as a term to the explore routes to search for that topic rather than the text. A query with no matches is `lookupStatus: "no_data"` with an empty `topics` array. An empty query is refused by the schema before any lookup.

## Request

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

## FAQ

### How do I use a suggestion id?

Prefix it with id:. For example, GET /v1/google-trends/interest-over-time?query=id:/m/02vqfm&geo=US compares the Coffee topic rather than the word coffee.

### Why are there only five topics?

The answer carries at most five, so data.limit is 5 and there is no paging parameter. Narrow the text when you need a different set.

### What does type contain?

A short label in the interface language, for example Beverage, Topic, Kitchenware or Color. It is free text, not a fixed enum, so do not branch on it.

### Does language translate the query?

No. language localises titles, dates and type text. It does not translate the text you send.

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