Get Google Trends interest by region
Get Google Trends search interest by place for one to five terms.
Headers
Get your API keyAPI key (`sfk_...`)
One to five search terms, comma-separated or repeated when a term contains a comma. A topic is `id:` plus a Knowledge Graph id (`id:/m/02vqfm`), as the suggestions endpoint returns it.
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`.
Category id from the categories endpoint. `0` (the default) means all categories.
≥ 0 · ≤ 9999999
Property to search: `web` (default), `images`, `news`, `youtube` or `shopping`.
one of: web, images, news, youtube, shopping
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})?$
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
Region resolution: `region` for subdivisions, `dma` for US metro areas, or `city`. The default is the one Google Trends picks for the geo. A place without a city-level breakdown is refused as input.
one of: region, dma, city
Include places with too little search volume to appear by default.
Endpoint-specific response payload.
`found` when the answer has data; `no_data` when it has none.
one of: found, no_data
The geo of this result; an empty string is worldwide.
The category of this result; 0 is all categories.
The property that was searched.
one of: web, images, news, youtube, shopping
The interface language.
The terms of this result, as given in the request (including an `id:` marker for a topic).
The time range of this result.
Whether low-volume places were asked for.
The resolution Google Trends used, e.g. `COUNTRY`, `REGION`, `DMA` or `CITY`.
Places, as Google Trends lists them. Rows with no data are kept when the term has data; a term with no data returns an empty list. City results carry at most 200 rows; DMA rows are prefixed with the requested state when the request names one, and keep the bare metro code for a national request because a national result carries no state.
Full place id, e.g. `US-CA` or `US-CA-807`; null for city rows, which carry coordinates instead.
Place name, localised by language.
One value per term, relative to the peak inside this request.
Whether each term has data in this place. Rows with no data are kept when the term has data somewhere.
Index of the compared term leading this place; null when not sent.
Coordinates, sent for city results only; null otherwise.
Latitude.
Longitude.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/google-trends/interest-by-region?query=coffee" \
-H "x-api-key: YOUR_API_KEY"Responses
Google Trends interest by region.