Search, news and trends

Google Trends

from $0.0030 per resulttrends.search

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.

FieldTypeRequiredWhat it does
modestringyesWhich 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.
geostringoptionalCountry 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.
keywordstringoptionalThe 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.
fetchRegionalDatabooleanoptionalAdd 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.
predefinedTimeframestringoptionalWindow 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.
trendingSearchesCountrystringoptionalCountry 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.
trendingSearchesMaxItemsintegeroptionalHow 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.
trendingSearchesTimeframestringoptionalHow 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.
trendingSearchesCategoriesarray of stringoptionalFilter 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.md

Or plain HTTP

POST /v1/run

{
  "endpoint": "trends.search",
  "input": {
    "mode": "keyword"
  }
}

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