Interest by region

Compare Google Trends interest scores by country or subregion for up to five keywords with optional date range and filters.

← All Google Trends endpoints · Capability overview

GET/v1/google-trends/interest-by-region

https://api.vee3.io/v1/google-trends/interest-by-region

40 tokens

Compare Google Trends interest scores by country or subregion for up to five keywords with optional date range and 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_by_region

Parameters8 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

resolution"COUNTRY" | "REGION"Optional

Geographic resolution: COUNTRY (default) or REGION.

Default: "COUNTRY"

Response2 fields

<keyword>object

1 field

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

<location>integer

Interest score for that location and 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-by-region"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "keywords": ["Marketing","AI"],
    "start": "2020-05-01T00:43:37+0100",
    "country": "",
    "region": "",
    "category": "",
    "gprop": "",
    "resolution": "COUNTRY"
}

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

Example responses1 example

200Country-level scores for two keywords (truncated).

marketing_and_ai.json

{
  "Marketing": {
    "United States": 22,
    "Germany": 25
  },
  "AI": {
    "United States": 78,
    "Japan": 98
  }
}