Skip to main content
GET
Google Trends — unified search

Authorizations

x-api-key
string
header
required

Query Parameters

q
string
required

Search term(s). Up to 5 comma-separated terms for TIMESERIES / GEO_MAP; single term for GEO_MAP_0 / RELATED_TOPICS / RELATED_QUERIES. Also accepts a topic MID.

data_type
enum<string>
default:TIMESERIES

Dispatch on: TIMESERIES (interest over time), GEO_MAP (compared breakdown, multi-query), GEO_MAP_0 (interest by region, single query), RELATED_TOPICS (top + rising topics), RELATED_QUERIES (top + rising queries).

Available options:
TIMESERIES,
GEO_MAP,
GEO_MAP_0,
RELATED_TOPICS,
RELATED_QUERIES
geo
string
default:""

Country / region code (e.g. US, GB, US-CA).

date
string
default:today 12-m

Time range.

cat
integer
default:0

Category filter ID (0 = all).

gprop
string
default:""

Property filter: "" (web), "images", "news", "froogle", "youtube".

region
string | null

Geo resolution for GEO_MAP / GEO_MAP_0: COUNTRY / REGION / DMA / CITY. Omit to use the widget's own default.

language
string | null

Alias for hl. Defaults to en-US.

tz
string
default:0

Timezone offset in minutes.

Response

Successful Response

Unified response for GET /api/v1/trends/search.

A single endpoint that dispatches on data_type (TIMESERIES, GEO_MAP, GEO_MAP_0, RELATED_TOPICS, RELATED_QUERIES). Only the field set relevant to the requested data_type is populated; others stay at their empty defaults.

query
string
required
data_type
string
required
timeline
TrendsTimelinePoint · object[]
averages
TrendsTimelineValue · object[]
regions
TrendsRegionInterest · object[]
top_topics
TrendsRelatedItem · object[]
rising_topics
TrendsRelatedItem · object[]
top_queries
TrendsRelatedItem · object[]
rising_queries
TrendsRelatedItem · object[]