Get Google Trends interest over time
Get Google Trends search interest over time 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})?$
One or two ranges for one term; two must differ. Named `now 1-H`/`4-H`/`1-d`/`7-d`, `today 1-m`/`3-m`/`12-m`/`5-y`, `all`; custom `YYYY-MM-DD YYYY-MM-DD`; named pairs must match in length. Default: `today 12-m`.
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, or the two ranges, of this result.
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.
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-over-time?query=coffee" \
-H "x-api-key: YOUR_API_KEY"Responses
Google Trends interest over time.