Google Trends data: interest over time, by region, related queries, and trending now.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Break down search interest for one term by geography. Use this when the user asks where something is popular, or wants a regional or city-level comparison. Values are normalized relative interest (0-100 within the result set).
A search term, or a topic id from search_topics (e.g. "/m/0mkz").
Country code such as "US", "GB", "TH"; a sub-region such as "US-CA"; or a US metro code such as "807". Empty string means worldwide.
Google Trends category id to restrict the query to; 0, the default, is every category. Narrowing disambiguates a word with several meanings without needing a topic id.
Time range. A preset, or a custom range as two ISO dates: "2023-01-01 2023-06-30". The range also sets granularity — hourly ranges return minute-level points and "all" returns monthly ones, so a long range cannot show a short spike.
Geographic granularity of the breakdown.
Which Google surface to measure: empty for web search, or images, news, youtube, or froogle (Shopping). These are separate indexes, so values from different properties are not comparable to each other.
Break down search interest for one term by geography. Use this when the user asks where something is popular, or wants a regional or city-level comparison. Values are normalized relative interest (0-100 within the result set).
| Argument | Type | Description |
|---|---|---|
| region | any | Country code such as "US", "GB", "TH"; a sub-region such as "US-CA"; or a US metro code such as "807". Empty string means worldwide. |
| keyword* | string | A search term, or a topic id from search_topics (e.g. "/m/0mkz"). |
| category | integer | Google Trends category id to restrict the query to; 0, the default, is every category. Narrowing disambiguates a word with several meanings without needing a topic id. |
| timeframe | any | Time range. A preset, or a custom range as two ISO dates: "2023-01-01 2023-06-30". The range also sets granularity — hourly ranges return minute-level points and "all" returns monthly ones, so a long range cannot show a short spike. |
| resolution | string | Geographic granularity of the breakdown. |
| searchProperty | string | Which Google surface to measure: empty for web search, or images, news, youtube, or froogle (Shopping). These are separate indexes, so values from different properties are not comparable to each other. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"keyword"
],
"properties": {
"region": {
"anyOf": [
{
"enum": [
"",
"US",
"GB",
"DE",
"FR",
"IT",
"ES",
"CA",
"AU",
"JP",
"IN",
"BR",
"MX",
"NL",
"SE",
"PL",
"TR"
],
"type": "string"
},
{
"type": "string",
"pattern": "^[A-Z]{2}(-[A-Z0-9]{1,3})?$"
},
{
"type": "string",
"pattern": "^\\d{3}$"
}
],
"description": "Country code such as \"US\", \"GB\", \"TH\"; a sub-region such as \"US-CA\"; or a US metro code such as \"807\". Empty string means worldwide."
},
"keyword": {
"type": "string",
"minLength": 1,
"description": "A search term, or a topic id from search_topics (e.g. \"/m/0mkz\")."
},
"category": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Google Trends category id to restrict the query to; 0, the default, is every category. Narrowing disambiguates a word with several meanings without needing a topic id."
},
"timeframe": {
"anyOf": [
{
"enum": [
"now 1-H",
"now 4-H",
"now 1-d",
"now 7-d",
"today 1-m",
"today 3-m",
"today 12-m",
"today 5-y",
"all"
],
"type": "string"
},
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{4}-\\d{2}-\\d{2}$"
}
],
"description": "Time range. A preset, or a custom range as two ISO dates: \"2023-01-01 2023-06-30\". The range also sets granularity — hourly ranges return minute-level points and \"all\" returns monthly ones, so a long range cannot show a short spike."
},
"resolution": {
"enum": [
"COUNTRY",
"REGION",
"CITY"
],
"type": "string",
"description": "Geographic granularity of the breakdown."
},
"searchProperty": {
"enum": [
"",
"images",
"news",
"youtube",
"froogle"
],
"type": "string",
"description": "Which Google surface to measure: empty for web search, or images, news, youtube, or froogle (Shopping). These are separate indexes, so values from different properties are not comparable to each other."
}
}
}Get relative search interest for one or more terms over a historical period. Use this when the user asks how popular something is, whether it is rising or falling, or how several things compare — passing multiple keywords compares them on one scale. Values are normalized relative interest (0-100 within the result set), not absolute search volume.
| Argument | Type | Description |
|---|---|---|
| region | any | Country code such as "US", "GB", "TH"; a sub-region such as "US-CA"; or a US metro code such as "807". Empty string means worldwide. |
| category | integer | Google Trends category id to restrict the query to; 0, the default, is every category. Narrowing disambiguates a word with several meanings without needing a topic id. |
| keywords* | array | 1-5 search terms. Pass several to compare them against each other. Accepts topic ids from search_topics (e.g. "/m/0mkz") as well as literal phrases. |
| timeframe | any | Time range. A preset, or a custom range as two ISO dates: "2023-01-01 2023-06-30". The range also sets granularity — hourly ranges return minute-level points and "all" returns monthly ones, so a long range cannot show a short spike. |
| searchProperty | string | Which Google surface to measure: empty for web search, or images, news, youtube, or froogle (Shopping). These are separate indexes, so values from different properties are not comparable to each other. |
Find the top and rising searches related to a term. Use this for keyword discovery, SEO and content research, and spotting breakout queries. `top` is ranked by volume; `rising` is ranked by growth, where "Breakout" means growth too large to measure.
| Argument | Type | Description |
|---|---|---|
| region | any | Country code such as "US", "GB", "TH"; a sub-region such as "US-CA"; or a US metro code such as "807". Empty string means worldwide. |
| keyword* | string | A search term, or a topic id from search_topics (e.g. "/m/0mkz"). |
| category | integer | Google Trends category id to restrict the query to; 0, the default, is every category. Narrowing disambiguates a word with several meanings without needing a topic id. |
| timeframe | any | Time range. A preset, or a custom range as two ISO dates: "2023-01-01 2023-06-30". The range also sets granularity — hourly ranges return minute-level points and "all" returns monthly ones, so a long range cannot show a short spike. |
| searchProperty | string | Which Google surface to measure: empty for web search, or images, news, youtube, or froogle (Shopping). These are separate indexes, so values from different properties are not comparable to each other. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"keyword"
],
"properties": {
"region": {
"anyOf": [
{
"enum": [
"",
"US",
"GB",
"DE",
"FR",
"IT",
"ES",
"CA",
"AU",
"JP",
"IN",
"BR",
"MX",
"NL",
"SE",
"PL",
"TR"
],
"type": "string"
},
{
"type": "string",
"pattern": "^[A-Z]{2}(-[A-Z0-9]{1,3})?$"
},
{
"type": "string",
"pattern": "^\\d{3}$"
}
],
"description": "Country code such as \"US\", \"GB\", \"TH\"; a sub-region such as \"US-CA\"; or a US metro code such as \"807\". Empty string means worldwide."
},
"keyword": {
"type": "string",
"minLength": 1,
"description": "A search term, or a topic id from search_topics (e.g. \"/m/0mkz\")."
},
"category": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Google Trends category id to restrict the query to; 0, the default, is every category. Narrowing disambiguates a word with several meanings without needing a topic id."
},
"timeframe": {
"anyOf": [
{
"enum": [
"now 1-H",
"now 4-H",
"now 1-d",
"now 7-d",
"today 1-m",
"today 3-m",
"today 12-m",
"today 5-y",
"all"
],
"type": "string"
},
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{4}-\\d{2}-\\d{2}$"
}
],
"description": "Time range. A preset, or a custom range as two ISO dates: \"2023-01-01 2023-06-30\". The range also sets granularity — hourly ranges return minute-level points and \"all\" returns monthly ones, so a long range cannot show a short spike."
},
"searchProperty": {
"enum": [
"",
"images",
"news",
"youtube",
"froogle"
],
"type": "string",
"description": "Which Google surface to measure: empty for web search, or images, news, youtube, or froogle (Shopping). These are separate indexes, so values from different properties are not comparable to each other."
}
}
}Lists the searches surging right now in a country, for questions about what is spiking without a term being named, and for news and real-time context. The `backend` parameter selects the source: "rpc" returns around 50 entries with growth percentages and a relative volume index; "rss" returns 10 entries together with the news articles behind each one; "auto" tries rpc and falls back to rss.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum number of results to return. |
| region | any | Country code such as "US", "GB", "TH"; a sub-region such as "US-CA"; or a US metro code such as "807". Empty string means worldwide. |
| backend | string | Source to use. "rpc" returns ~50 items with growth percentages; "rss" returns 10 with the news articles behind each trend; "auto" tries rpc then falls back to rss. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Maximum number of results to return."
},
"region": {
"anyOf": [
{
"enum": [
"",
"US",
"GB",
"DE",
"FR",
"IT",
"ES",
"CA",
"AU",
"JP",
"IN",
"BR",
"MX",
"NL",
"SE",
"PL",
"TR"
],
"type": "string"
},
{
"type": "string",
"pattern": "^[A-Z]{2}(-[A-Z0-9]{1,3})?$"
},
{
"type": "string",
"pattern": "^\\d{3}$"
}
],
"description": "Country code such as \"US\", \"GB\", \"TH\"; a sub-region such as \"US-CA\"; or a US metro code such as \"807\". Empty string means worldwide."
},
"backend": {
"enum": [
"auto",
"rpc",
"rss"
],
"type": "string",
"description": "Source to use. \"rpc\" returns ~50 items with growth percentages; \"rss\" returns 10 with the news articles behind each trend; \"auto\" tries rpc then falls back to rss."
}
}
}Returns the geo codes Google Trends accepts. With no argument it lists every country; given a country code it lists that country's sub-regions — US states, German states, UK nations — each as a code and a name. Any code returned here can be passed as the `region` argument of the other tools.
| Argument | Type | Description |
|---|---|---|
| country | any | Country code such as "US", "GB", "TH"; a sub-region such as "US-CA"; or a US metro code such as "807". Empty string means worldwide. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"country": {
"anyOf": [
{
"enum": [
"",
"US",
"GB",
"DE",
"FR",
"IT",
"ES",
"CA",
"AU",
"JP",
"IN",
"BR",
"MX",
"NL",
"SE",
"PL",
"TR"
],
"type": "string"
},
{
"type": "string",
"pattern": "^[A-Z]{2}(-[A-Z0-9]{1,3})?$"
},
{
"type": "string",
"pattern": "^\\d{3}$"
}
],
"description": "Country code such as \"US\", \"GB\", \"TH\"; a sub-region such as \"US-CA\"; or a US metro code such as \"807\". Empty string means worldwide."
}
}
}Researches up to 10 topics in a single call, each with the same full picture as `research_trend`: interest over time, where it is most searched, and related queries. Each topic is looked up on its own scale, so they are not comparable to one another. Use this when you need data across many topics — a long or rich research pass — instead of one tool call per topic. Each section is fetched independently, so a partial result is normal: any section that fails carries an `error` instead of data and the rest still returns.
| Argument | Type | Description |
|---|---|---|
| region | any | Country code such as "US", "GB", "TH"; a sub-region such as "US-CA"; or a US metro code such as "807". Empty string means worldwide. |
| topics* | array | 1-10 topics (terms or topic ids) to research. Each is looked up on its own scale, so they are not comparable to one another. Use this to gather data across many topics in one call instead of one tool call per topic. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"topics"
],
"properties": {
"region": {
"anyOf": [
{
"enum": [
"",
"US",
"GB",
"DE",
"FR",
"IT",
"ES",
"CA",
"AU",
"JP",
"IN",
"BR",
"MX",
"NL",
"SE",
"PL",
"TR"
],
"type": "string"
},
{
"type": "string",
"pattern": "^[A-Z]{2}(-[A-Z0-9]{1,3})?$"
},
{
"type": "string",
"pattern": "^\\d{3}$"
}
],
"description": "Country code such as \"US\", \"GB\", \"TH\"; a sub-region such as \"US-CA\"; or a US metro code such as \"807\". Empty string means worldwide."
},
"topics": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 10,
"minItems": 1,
"description": "1-10 topics (terms or topic ids) to research. Each is looked up on its own scale, so they are not comparable to one another. Use this to gather data across many topics in one call instead of one tool call per topic."
}
}
}Returns a full picture of one term in a single call: interest over time, where it is most searched, and the queries people search alongside it. Suited to open-ended research on a topic rather than one narrow question. Each section is fetched independently, so a partial result is normal: any section that fails carries an `error` instead of data and the rest still returns.
| Argument | Type | Description |
|---|---|---|
| region | any | Country code such as "US", "GB", "TH"; a sub-region such as "US-CA"; or a US metro code such as "807". Empty string means worldwide. |
| keyword* | string | A search term, or a topic id from search_topics (e.g. "/m/0mkz"). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"keyword"
],
"properties": {
"region": {
"anyOf": [
{
"enum": [
"",
"US",
"GB",
"DE",
"FR",
"IT",
"ES",
"CA",
"AU",
"JP",
"IN",
"BR",
"MX",
"NL",
"SE",
"PL",
"TR"
],
"type": "string"
},
{
"type": "string",
"pattern": "^[A-Z]{2}(-[A-Z0-9]{1,3})?$"
},
{
"type": "string",
"pattern": "^\\d{3}$"
}
],
"description": "Country code such as \"US\", \"GB\", \"TH\"; a sub-region such as \"US-CA\"; or a US metro code such as \"807\". Empty string means worldwide."
},
"keyword": {
"type": "string",
"minLength": 1,
"description": "A search term, or a topic id from search_topics (e.g. \"/m/0mkz\")."
}
}
}Resolves a name — a company, product, person, technology, or concept — to its Google Trends topic id (`mid`), with a `type` field that distinguishes same-name entities such as Nike the company from Nike the goddess. A topic aggregates every spelling and translation of one concept, so it measures considerably more search activity than a literal phrase: the topic for "artificial intelligence" scores 62 where the literal string scores 1. The other TrendFlow tools accept a topic id anywhere they accept a keyword.
| Argument | Type | Description |
|---|---|---|
| query* | string | A search term, or a topic id from search_topics (e.g. "/m/0mkz"). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"minLength": 1,
"description": "A search term, or a topic id from search_topics (e.g. \"/m/0mkz\")."
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"keywords"
],
"properties": {
"region": {
"anyOf": [
{
"enum": [
"",
"US",
"GB",
"DE",
"FR",
"IT",
"ES",
"CA",
"AU",
"JP",
"IN",
"BR",
"MX",
"NL",
"SE",
"PL",
"TR"
],
"type": "string"
},
{
"type": "string",
"pattern": "^[A-Z]{2}(-[A-Z0-9]{1,3})?$"
},
{
"type": "string",
"pattern": "^\\d{3}$"
}
],
"description": "Country code such as \"US\", \"GB\", \"TH\"; a sub-region such as \"US-CA\"; or a US metro code such as \"807\". Empty string means worldwide."
},
"category": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Google Trends category id to restrict the query to; 0, the default, is every category. Narrowing disambiguates a word with several meanings without needing a topic id."
},
"keywords": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 5,
"minItems": 1,
"description": "1-5 search terms. Pass several to compare them against each other. Accepts topic ids from search_topics (e.g. \"/m/0mkz\") as well as literal phrases."
},
"timeframe": {
"anyOf": [
{
"enum": [
"now 1-H",
"now 4-H",
"now 1-d",
"now 7-d",
"today 1-m",
"today 3-m",
"today 12-m",
"today 5-y",
"all"
],
"type": "string"
},
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{4}-\\d{2}-\\d{2}$"
}
],
"description": "Time range. A preset, or a custom range as two ISO dates: \"2023-01-01 2023-06-30\". The range also sets granularity — hourly ranges return minute-level points and \"all\" returns monthly ones, so a long range cannot show a short spike."
},
"searchProperty": {
"enum": [
"",
"images",
"news",
"youtube",
"froogle"
],
"type": "string",
"description": "Which Google surface to measure: empty for web search, or images, news, youtube, or froogle (Shopping). These are separate indexes, so values from different properties are not comparable to each other."
}
}
}