Interest over time
Compare Google Trends interest scores over time for up to five keywords with optional geography, category, and property filters.
← All Google Trends endpoints · Capability overview
/v1/google-trends/interest-over-timehttps://api.vee3.io/v1/google-trends/interest-over-time
Compare Google Trends interest scores over time for up to five keywords with optional geography, category, and property filters.
Authorization
Send your API key in the Authorization header:
Authorization: Bearer YOUR_API_KEY
MCP
The same capability is available as an MCP tool on Vee3 hosted MCP.
Tool name
get_google_trends_interest_over_timeParameters7 fields
keywordsarrayRequiredUp to five keywords to compare.
min 1, max 5
startstringRequiredRange start in datetime-with-timezone form (for example 2020-05-01T00:43:37+0100).
max length 64
endstringOptionalRange end in datetime-with-timezone form. Defaults to now.
max length 64
countrystringOptionalCountry name for geo filtering. Defaults to global.
max length 128
regionstringOptionalRegion within country. Requires country when set.
max length 128
categorystringOptionalTrends category or subcategory. Defaults to all.
max length 256
gpropstringOptionalGoogle property filter (for example images, news, youtube, froogle). Defaults to all.
max length 64
Response2 fields
<keyword>object1 fieldEach requested keyword appears as a top-level key mapping timestamp strings to interest scores (integers 0–100).
<keyword>object<timestamp>integerInterest score at that timestamp for the keyword.
HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, google_trends_not_configured, google_trends_upstream_error