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

GET/v1/google-trends/interest-over-time

https://api.vee3.io/v1/google-trends/interest-over-time

40 tokens

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_time

Parameters7 fields

keywordsarrayRequired

Up to five keywords to compare.

min 1, max 5

startstringRequired

Range start in datetime-with-timezone form (for example 2020-05-01T00:43:37+0100).

max length 64

endstringOptional

Range end in datetime-with-timezone form. Defaults to now.

max length 64

countrystringOptional

Country name for geo filtering. Defaults to global.

max length 128

regionstringOptional

Region within country. Requires country when set.

max length 128

categorystringOptional

Trends category or subcategory. Defaults to all.

max length 256

gpropstringOptional

Google property filter (for example images, news, youtube, froogle). Defaults to all.

max length 64

Response2 fields

<keyword>object

1 field

Each requested keyword appears as a top-level key mapping timestamp strings to interest scores (integers 0–100).

<timestamp>integer

Interest score at that timestamp for the keyword.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, google_trends_not_configured, google_trends_upstream_error

Example request

Python

import requests

url = "https://api.vee3.io/v1/google-trends/interest-over-time"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "keywords": ["France","Italy","Germany"],
    "start": "2020-05-01T00:43:37+0100",
    "country": "France",
    "region": "Alsace",
    "category": "",
    "gprop": ""
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Monthly interest scores for three keywords (truncated).

three_keywords.json

{
  "France": {
    "2020-05-01T00:00:00": 63,
    "2021-06-01T00:00:00": 100
  },
  "Italy": {
    "2020-05-01T00:00:00": 0,
    "2021-06-01T00:00:00": 0
  }
}