related_topics
Get top and rising related topics for a keyword to uncover Google Trends topic clusters and breakout growth.
Instructions
Top and rising related topics (Google's topic clusters, not raw query strings) for a single keyword.
Args: keyword: a single search term. timeframe: pytrends timeframe string, e.g. "today 12-m". geo: ISO country code (e.g. "US", "IN"), or "" for worldwide (default). response_format: "concise" (default) returns only the top 10 of each list, sorted by "value" descending, rounded to whole numbers. "full" returns every row, unrounded.
Returns: A dict with two keys, each containing a list of topic records: - "top": most-searched related topics. Each record has "topic_title", "topic_type", "value" (0-100 relative interest on Google Trends scale). - "rising": fastest-growing related topics. Each record has "topic_title", "topic_type", "value". IMPORTANT: a value of 5000% is Google's "Breakout" marker, indicating explosive new growth from near-zero baseline, NOT a literal 5000% increase. This is the same convention as "rising" queries.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"keyword": "<keyword>"
},
"name": "related_topics"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| geo | No | ||
| keyword | Yes | ||
| timeframe | No | today 12-m | |
| response_format | No | concise |