Social Fetch
Start for freeStart free
Google Trends hub

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

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

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.

Google Trends Suggestions API 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.

Other Google Trends endpoints