Google Trends

Google Trends data. Explore trending searches, interest over time, related queries, and regional breakdowns.

GET/v1/google-trends/suggestions

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

10 tokens

Autocomplete-style topic and entity suggestions for a Google Trends keyword.

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.suggestions

Parameters1 field

keywordstringRequired

Keyword or phrase to get suggestions for.

max length 512

Response4 fields

resultarrayitems

3 fields

Suggested topics and entities for the keyword.

midstring

Google Trends topic or entity identifier.

titlestring

Display title for the suggestion.

typestring

Suggestion kind (for example Topic, Software, Book).

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

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

Example responses1 example

200Topic suggestions for amazon.

amazon_suggestions.json

{
  "result": [
    {
      "mid": "/g/11cm12hhlm",
      "title": "Amazon",
      "type": "Topic"
    },
    {
      "mid": "/g/11c538nt6d",
      "title": "Amazon Alexa",
      "type": "Software"
    }
  ]
}

GET/v1/google-trends/categories

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

5 tokens

List valid Google Trends category and subcategory names for the category request field.

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.categories

Parameters0 fields

Response3 fields

catarrayitems

1 field

Category and subcategory names accepted by the category field.

<category>string

A single category or subcategory label.

msgstring

Status or informational message from the upstream API (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/categories"
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 list of category labels.

sample_categories.json

{
  "cat": [
    "Celebrities & Entertainment News",
    "Animated Films",
    "Travel",
    "All categories"
  ],
  "msg": ""
}

GET/v1/google-trends/regions

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

5 tokens

List countries and their subregions for Google Trends country and region request fields.

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

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

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

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

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

GET/v1/google-trends/related-queries

https://api.vee3.io/v1/google-trends/related-queries

40 tokens

Top and rising related search queries 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

google-trends.related_queries

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

Response11 fields

<keyword>object

10 fields

Related query rankings for one keyword.

topobject

4 fields

Top related queries by rank.

queryobject

1 field

Rank index to related query string.

<rank>string

Related query text at this rank.

valueobject

1 field

Rank index to interest score.

<rank>integer

Score at this rank.

risingobject

4 fields

Rising related queries by rank.

queryobject

1 field

Rank index to related query string.

<rank>string

Related query text at this rank.

valueobject

1 field

Rank index to breakout or growth score.

<rank>integer

Score at this rank.

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/related-queries"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "keywords": ["France","Italy","Germany"],
    "start": "2020-05-01T00:43:37+0100",
    "country": "France",
    "region": "",
    "category": "",
    "gprop": ""
}

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

Example responses1 example

200Top and rising related queries for three keywords (truncated).

three_keywords.json

{
  "France": {
    "top": {
      "query": {
        "0": "meteo france",
        "1": "air france"
      },
      "value": {
        "0": 100,
        "1": 35
      }
    },
    "rising": {
      "query": {
        "0": "tour de france 2025"
      },
      "value": {
        "0": 23750
      }
    }
  }
}