Google Trends
Google search demand for a term over time, as an interest index of 0 to 100 with an optional ranked regional breakdown, or the searches spiking in one country right now with estimated volumes and related terms.
One result per call in either mode.
What a call costs
Billed on actual usage, minimum $0.0020 per call, capped at $0.20 per call.
a price before every call. failed calls are never charged.
When to use it
Use when the question is about SEARCH DEMAND rather than about posts: is interest in this rising or dying, when did it peak, is it seasonal, which regions want it most, or what is spiking in a country today. This is the only endpoint that returns a time series, and it counts everyone who typed the query into Google rather than the small minority who post about it. For what people are SAYING use twitter.search or reddit.posts, for what is popular ON a platform use tiktok.api, for what publishers wrote use news.search, for what ranks use web.search. Set mode first. Keyword mode takes ONE term per call, so a five-term comparison is five calls, and interest is indexed within the geo and window you asked for, so results from different settings are not comparable in absolute terms. Every call costs the same flat amount whether it returns five rows or five hundred, because the cost is almost entirely a fixed start fee.
Inputs
Google Trends takes 9 fields, 1 of them required. Anything you leave out falls back to the tool's own default.
| Field | Type | Required | What it does |
|---|---|---|---|
| mode | string | yes | Which question you are asking. keyword measures one search term over time. trending lists the terms spiking in one country right now. Required here even though the actor has a default, because that default is trending: a call that meant to analyse a keyword and forgot this field gets billed in full for a country's trending list instead. |
| geo | string | optional | Country to measure interest in, for mode keyword, as a two-letter code. Leave it out, or send the empty string, for worldwide. The 0 to 100 index is computed WITHIN whatever geo and window you ask for, so a 100 in Romania and a 100 in the United States are not the same amount of searching. |
| keyword | string | optional | The search term to measure, for mode keyword. One term per call, since the actor takes a single string and not a list. Leave it out and the actor falls back to its own example term, bitcoin, and charges you for it. |
| fetchRegionalData | boolean | optional | Add region_data to a mode keyword result: every region of the chosen country, ranked and scored 0 to 100. Off unless you set it. Needs geo set, since worldwide has no regions to break down. Costs nothing extra, the call is one billed item either way. |
| predefinedTimeframe | string | optional | Window for mode keyword. The actor uses today 12-m when you leave it out. Google picks the granularity to fit the window and reports it back as data_granularity: minute for now 1-h, hour for the other now windows, day up to today 3-m, week for today 12-m, month for today 5-y and all. |
| trendingSearchesCountry | string | optional | Country for mode trending, as a two-letter code. The actor uses US when you leave it out. This list is not the same as the geo list above: trending covers 125 countries, keyword interest covers 150 plus worldwide. |
| trendingSearchesMaxItems | integer | optional | How many trending terms to pack into the single result, for mode trending. The actor returns 50 when you leave it out. This does NOT change the price: the whole list arrives inside one dataset item, so asking for 5 costs exactly what asking for 100 costs. |
| trendingSearchesTimeframe | string | optional | How far back mode trending looks, in HOURS, sent as a string: 4, 24, 48 or 168 for one week. The actor uses 24 when you leave it out. A shorter window surfaces breaking spikes, a longer one surfaces what has stayed up. |
| trendingSearchesCategories | array of string | optional | Filter mode trending to these Google Trends categories, as string ids: 1 autos and vehicles, 2 beauty and fashion, 3 business and finance, 4 entertainment, 5 food and drink, 6 games, 7 health, 8 hobbies and leisure, 9 jobs and education, 10 law and government, 11 other, 13 pets and animals, 14 politics, 15 science, 16 shopping, 17 sports, 18 technology, 19 travel and transportation, 20 climate. There is no 12. Every category when you leave it out. |
How to call it
Connect once and your agent can reach Google Trends the same way it reaches everything else in the catalog. Add Goro as an MCP connector, or paste the setup line into an agent that reads skills.
MCP
Add this server in Claude, Claude Code, or any MCP client.
https://mcp.usegoro.ai/mcp
Skill
One line in your agent's chat. It sets itself up.
set up https://usegoro.ai/SKILL.mdOr plain HTTP
POST /v1/run
{
"endpoint": "trends.search",
"input": {
"mode": "keyword"
}
}Related tools
More from search, news and trends, or browse the full tool catalog.
Google News search
News articles from Google News for one or more keywords, sections or topic URLs, with headline, publisher, publish time, link and image, in any of 80...
from $0.0120 per resultWeb search
Run a Google web search and get back ranked organic results with title, url, and snippet.
from $0.0075 per pageFurther reading: How to give Claude access to real-time web data
Run Google Trends from your agent.
One balance for every tool in the catalog. Start with Build, $25 of credit for $19 a month.
Get started