Skip to main content
GET
Google Trends — current trending searches

Authorizations

x-api-key
string
header
required

Query Parameters

geo
string
default:US

Country code (e.g. US, LT, GB).

hours
integer
default:24

Look-back window in hours. Google's UI supports 4, 24, 48, 168. Passed through to the upstream feed; the public RSS currently ignores this filter.

category
string
default:all

Category filter. Accepts Google's letter codes (b business, e entertainment, m health, t sci/tech, s sports, h top stories) or the friendly aliases (business, entertainment, health, sci_tech/technology, sports, top_stories). all (default) returns every category.

status
enum<string>
default:all

Trend state. active keeps only entries with a non-zero search volume (still surging); all (default) returns every entry including ended ones.

Available options:
all,
active
sort
enum<string>
default:relevance

Sort order. relevance (default) keeps Google's ordering; search_volume orders by parsed traffic descending; title sorts alphabetically; recency falls back to relevance when the feed omits publication timestamps.

Available options:
relevance,
search_volume,
title,
recency
hl
string
default:en-US

Language code.

Response

Successful Response

Response for GET /api/v1/trends/trending.

country
string
default:US