Get Google Trends report
Get Google Trends interest over time, by region and related queries in one request.
Headers
Get your API keyAPI key (`sfk_...`)
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
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
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 term of this result.
The time range of this result.
The interest-over-time series.
The granularity Google Trends chose, e.g. `MINUTE`, `HOUR`, `DAY`, `WEEK`, `MONTH`.
The series, oldest first.
The point's time, ISO 8601 UTC; null when the series carries no time.
Localised axis label, as written (including its thin spaces and dashes).
One value per term, relative to the peak inside this request (0 to 100).
Whether each term has data at this point.
Whether the point is partial: false normally, true for the last point of a live range.
In a two-period comparison, which range this point belongs to (0 or 1); null for one range.
≥ 0 · ≤ 1
One average per term, or one per period in a two-period comparison; empty when Google Trends has none.
Google Trends' own data-change notes for the series; empty when it sent none.
The interest-by-region data.
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.
The related-query lists.
Top related queries, at most 25 from Google Trends.
The related query text.
Relative popularity, 0 to 100; null when not sent.
≥ 0 · ≤ 100
Rising related queries, at most 25 from Google Trends.
The related query text.
How the query is rising.
Google Trends' numeric rise; null for a breakout.
Whether Google Trends marked it as a breakout.
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/report?query=coffee" \
-H "x-api-key: YOUR_API_KEY"Responses
Google Trends report.