Google Trends

List Google Trends topic suggestions

Try in Playground

List the topics Google Trends suggests for a text.

Try in Playground

GET/v1/google-trends/suggestions

1credit

Headers

Get your API key

x-api-keystringheader

API key (`sfk_...`)

Parameters

2

querystringrequiredquery

Text to suggest topics for, 1 to 120 characters.

min 1 chars · max 120 chars

languagestringoptionalquery

Interface language, as Google calls `hl` (`en-US`, `de`, `ja`, `ar`). It localises names, dates and type text; it does not translate the queries.

pattern: ^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})?$

Response fields

13

Endpoint-specific response payload.

datalookupStatus

string

`found` when at least one topic matches; `no_data` when the query has no matches.

one of: found, no_data

dataquery

string

The text that was suggested for.

datalanguage

string

The interface language.

datalimit

number

Google Trends suggests at most five topics; there is no parameter for more.

one of: 5

At most five topics; an unmatched query returns none.

datatopics[]id

string

Knowledge Graph id (`/m/...` or `/g/...`). Use it as `id:<id>` in a query to mean the topic.

datatopics[]title

string

Topic title, localised by language.

datatopics[]type

string

What the entity is, in the interface language (free text, not an enum).

Metadata describing the request and billing outcome.

metarequestId

string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged

integer

Credits charged for this request.

≥ 0

metaversion

string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/google-trends/suggestions?query=coffee" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Google Trends topic suggestions.

Headlines

List the ten searches trending on Google Trends with their news.

Places

List the places Google Trends explore requests accept.