Regions

Countries and the regions inside them. Afghanistan includes Kabul and Herat. Albania includes Tirana.

MCP returns that map. The API returns the same geography with a GET. Interest over time and Interest by region use a country name from it when the numbers should cover one place.

GET/v1/google-trends/regions

https://api.vee3.io/v1/google-trends/regions

5 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.regions

Parameters0 fields

Response7 fields

geoobject

5 fields

Geographic options keyed by country name.

countriesobject

4 fields

Map of country name to country metadata and subregions.

<country>object

3 fields

Country entry keyed by country name.

countrystring

Country label.

regionsarrayitems

1 field

Subregion names within the country.

<region>string

A single subregion name.

msgstring

Status or informational message (often empty).

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/regions"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {

}

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

Example responses1 example

200Truncated country and subregion listing.

sample_countries.json

{
  "geo": {
    "countries": {
      "Afghanistan": {
        "country": "Afghanistan",
        "regions": [
          "Kabul",
          "Herat"
        ]
      },
      "Albania": {
        "country": "Albania",
        "regions": [
          "Tirana",
          "Durrës"
        ]
      }
    }
  },
  "msg": ""
}