List Google Trends trending searches
List the searches trending on Google Trends by place.
Headers
Get your API keyAPI key (`sfk_...`)
Place: an ISO 3166-1 country code (`US`, `DE`) or a subdivision code (`US-CA`, `DE-BY`). Lowercase input is accepted and normalised to uppercase. Default: `US`.
pattern: ^[A-Z]{2}(?:-[A-Z0-9]{1,3}){0,2}$
Window in hours: 4, 24, 48 or 168. Default: 24. Google Trends offers no other window.
Trending category id: `0` (all, default), 1 to 11 or 13 to 20; for example `17` is Sports. This is the trending list's own set, not the categories endpoint's tree.
Only trends still active (`true`) or only ended ones (`false`). Omit for both.
How to order the list: `recency` (newest start first, the default) or `volume` (largest search-volume bucket first).
one of: recency, volume
Trends per page, 1 to 100. Default: 25.
≥ 1 · ≤ 100
Cursor from `page.nextCursor` of the previous response. It only works with the same filters.
min 1 chars · max 1024 chars
Endpoint-specific response payload.
`found` when Google Trends has a list for this geo. A geo Google Trends does not serve is a 400 from the API.
one of: found
The geo of this result.
The window of this result, in hours.
The trending category filter that was applied; null when none was.
The active/ended filter that was applied; null when both were kept.
The order of the rows.
one of: recency, volume
Maximum number of trends this page could carry.
≤ 100
Trends for this page, newest start first when sorted by recency. Google Trends lists at most a few thousand per geo and window.
The trending query, in the local language.
The geo Google Trends echoes for the item; null when absent.
When the trend started, ISO 8601 UTC; null when absent.
When it stopped, ISO 8601 UTC; null while it is active.
Search-volume bucket, e.g. 100, 1000 or 500000; null when absent.
Growth step on Google Trends' own scale (50, 75, 100, 200 ... 1000), read as a percentage; null when absent.
Related searches; the first entry is the query itself.
Category ids from the trending list's own category set; use the `category` parameter's list for their names.
Names for the category ids above, in the same order; an id without a known name is omitted.
Pagination state for the current page.
Whether another page is available.
Cursor for the next page; null on the last page.
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/trending?geo=US&hours=24&limit=10" \
-H "x-api-key: YOUR_API_KEY"Responses
Google Trends trending.