Related queries

A keyword such as France returns top queries like meteo france and rising ones like tour de france 2025. Each keyword has a top list and a rising list.

Agents fetch those lists through MCP. The API returns them with a GET. Suggestions turns a loose word into a topic id first.

GET/v1/google-trends/related-queries

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

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