Interest by region
Where people searched. In one sample, Marketing scores 22 in the United States and AI scores 98 in Japan, both on a 0 to 100 scale.
That breakdown is a GET on the API. An agent compares places by sending the keywords through MCP. Regions lists the country and region names.
/v1/google-trends/interest-by-regionhttps://api.vee3.io/v1/google-trends/interest-by-region
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_by_regionParameters8 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
resolution"COUNTRY" | "REGION"OptionalGeographic resolution: COUNTRY (default) or REGION.
Default: "COUNTRY"
Response2 fields
<keyword>object1 fieldEach requested keyword appears as a top-level key mapping location names to interest scores (integers 0–100).
<keyword>object<location>integerInterest score for that location and keyword.
HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, google_trends_not_configured, google_trends_upstream_error