Google Trends

Get Google Trends related queries

Get the top and rising related queries on Google Trends.

GET/v1/google-trends/related-queries
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
6
querystringrequiredquery

One search term, or a topic as `id:` followed by a Knowledge Graph id (`id:/m/02vqfm`). A single term may contain a comma; send it as one parameter value.

min 1 chars · max 100 chars

geooptionalquery

Place: a country code (`US`, `DE`), a subdivision (`US-CA`, `DE-BY`) or an empty string for worldwide. Lowercase input is accepted and normalised to uppercase. Default: `US`.

categoryintegeroptionalquery

Category id from the categories endpoint. `0` (the default) means all categories.

≥ 0 · ≤ 9999999

sourcestringoptionalquery

Property to search: `web` (default), `images`, `news`, `youtube` or `shopping`.

one of: web, images, news, youtube, shopping

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})?$

timestringoptionalquery

Time range: `now 1-H`, `now 4-H`, `now 1-d`, `now 7-d`, `today 1-m`, `today 3-m`, `today 12-m`, `today 5-y`, `all`, or a custom `YYYY-MM-DD YYYY-MM-DD` range (hourly `YYYY-MM-DDTHH` is accepted).

max 64 chars

Response fields
20

Endpoint-specific response payload.

datalookupStatus
string

`found` when the answer has data; `no_data` when it has none.

one of: found, no_data

datageo
string

The geo of this result; an empty string is worldwide.

datacategory
integer

The category of this result; 0 is all categories.

datasource
string

The property that was searched.

one of: web, images, news, youtube, shopping

datalanguage
string

The interface language.

dataquery
string

The term of this result.

datatime
string

The time range of this result.

Top related queries, at most 25 from Google Trends.

datatop[]query
string

The related query text.

datatop[]value
integernullable

Relative popularity, 0 to 100; null when not sent.

≥ 0 · ≤ 100

Rising related queries, at most 25 from Google Trends.

datarising[]query
string

The related query text.

How the query is rising.

datarising[]changepercent
numbernullable

Google Trends' numeric rise; null for a breakout.

datarising[]changebreakout
boolean

Whether Google Trends marked it as a breakout.

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/related-queries?query=coffee" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Google Trends related queries.