Interest over time

Compare keywords such as France, Italy, and Germany. Each one is a series of timestamps with an interest score from 0 to 100.

The series comes from a GET on the API. Agents pull it with MCP. Suggestions supplies a topic id when several topics share the word. Categories and Regions name the category and the place.

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

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

40 tokens

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

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
  }
}