Skip to main content
GET
Interest over time

Time range (date)

The date parameter only accepts Google Trends’ own time-range formats — there is no arbitrary custom range outside the values Google itself supports.
The explicit YYYY-MM-DD YYYY-MM-DD form must still fall within Google’s accepted bounds (from 2004 to the present). Values outside these formats are rejected.

Authorizations

x-api-key
string
header
required

Query Parameters

q
string
required

Search term(s), comma-separated (max 5)

geo
string
default:""

Geographic location (e.g. US, GB)

date
string
default:today 12-m

Time range (e.g. 'now 1-H', 'today 12-m', 'all', or 'YYYY-MM-DD YYYY-MM-DD')

category
integer
default:0

Category filter (0 = all)

gprop
string
default:""

Property: web, images, news, froogle, youtube

Response

Successful Response

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

query
string
required
timeline
TrendsTimelinePoint · object[]
averages
TrendsTimelineValue · object[]