Google API: List trending searches
Lists Google Trends 'Trending now' searches for a country, time window and category, in Google's order. Each search comes with its volume, activity, related searches and news headlines.
Unofficial. Not affiliated with or endorsed by Google.
Inputs
Values from the run on Oct 28, 2026, shown under Output.
- Country optional
country Country name or two-letter code, for example United States or US.
US
Default
United States.- Category optional
category Trend category in words, for example sports, entertainment, business and finance, technology, politics, health, or all.
all
Default
all.- Active Only optional
active_only Show only searches still trending, for example true.
false
True or false. Default
false.- Max Results optional
max_results Maximum number of trends to return, for example 25.
100
Whole number from 1 to 100. Default
25.- Time Window optional
time_window How far back to look, for example past_24_hours.
past_7_days
One of
past_4_hours,past_24_hours,past_48_hours,past_7_days. Defaultpast_24_hours.
Input as JSON
{ "country": "US", "category": "all", "active_only": false, "max_results": 100, "time_window": "past_7_days"}Output
{ "trends": [ { "page_link": "https://trends.google.com/trends/explore?date=now+7-d&geo=US&q=brewers+vs+rays" , "search_term": "brewers vs rays", "still_active": true, "search_volume": "2M+", "news_headlines": [ { "link": "https://www.espn.com/mlb/story/_/id/50304403/rays-steal-game-4-extras-stay-alive-world-series" , "title": "Rays steal Game 4 from Brewers in extras to stay alive in World Series", "publisher": "ESPN" }, { "link": "https://sports.yahoo.com/articles/brewers-manager-pat-murphy-reacts-075804043.html" , "title": "Brewers manager Pat Murphy reacts to 12-inning loss in Game 4 of World Series", "publisher": "Yahoo Sports" }, { "link": "https://www.fox13news.com/live-blog/news/world-series-game-4-updates-tampa-bay-rays-vs-milwaukee-brewes" , "title": "World Series, Game 4 live updates: Tampa Bay Rays vs. Milwaukee Brewers", "publisher": "FOX 13 Tampa Bay" } ], "related_searches": [ "rays vs brewers", "world series score", "world series game 4" ], "started_trending": "2026-10-23T02:30:00+00:00", "search_volume_number": 2000000 }, { "page_link": "https://trends.google.com/trends/explore?date=now+7-d&geo=US&q=donnie+iris" , "search_term": "donnie iris", "still_active": true, "search_volume": "200K+", "news_headlines": [ { "link": "https://www.post-gazette.com/news/obituaries/2026/10/26/donnie-iris-pittsburgh-dies/stories/202610260040" , "title": "Donnie Iris, Pittsburgh’s rock legend who scored hits with ‘Ah! Leah!’ and ‘The Rapper,’ dies at 83", "publisher": "Pittsburgh Post-Gazette" }, { "link": "https://triblive.com/local/regional/donnie-iris-death-prompts-outpouring-of-tributes-on-social-media/" , "title": "Donnie Iris’ death prompts outpouring of tributes on social media", "publisher": "TribLIVE.com" }, { "link": "https://www.timesonline.com/story/entertainment/local/2026/10/26/less-than-a-month-after-retiring-donnie-iris-has-died-at-83-beaver-county-pa/92452152007/" , "title": "King Cool: Donnie Iris dies at 83", "publisher": "Beaver County Times" } ], "related_searches": [], "started_trending": "2026-10-26T22:10:00+00:00", "search_volume_number": 200000 }, { "page_link": "https://trends.google.com/trends/explore?date=now+7-d&geo=US&q=israel+elections" , "search_term": "israel elections", "still_active": true, "search_volume": "500K+", "news_headlines": [ { "link": "https://www.reuters.com/world/middle-east/netanyahu-eisenkot-stake-rival-claims-lead-israel-after-deadlocked-vote-2026-10-28/" , "title": "Netanyahu, Eisenkot stake rival claims to lead Israel after deadlocked vote", "publisher": "Reuters" }, { "link": "https://www.timesofisrael.com/liveblog_entry/with-72-of-ballots-counted-netanyahu-led-bloc-at-54-seats-arab-parties-strengthen-to-18/" , "title": "With 72% of ballots counted, Netanyahu-led bloc at 54 seats; Arab parties strengthen to 18", "publisher": "The Times of Israel" }, { "link": "https://www.cnn.com/2026/10/27/middleeast/israel-elections-outcome-analysis-hnk-intl" , "title": "Israel just voted in a critical election. But we still don’t know what the ultimate outcome will be", "publisher": "CNN" } ], "related_searches": [ "israel election results", "netanyahu", "israel election" ], "started_trending": "2026-10-24T11:50:00+00:00", "search_volume_number": 500000 } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"trends.google.com/list_trending_searches","input":{"country":"US","category":"all","active_only":false,"max_results":100,"time_window":"past_7_days"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "trends.google.com/list_trending_searches" , "input": { "country": "US", "category": "all", "active_only": False, "max_results": 100, "time_window": "past_7_days" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "trends.google.com/list_trending_searches" , "input": { "country": "US", "category": "all", "active_only": false, "max_results": 100, "time_window": "past_7_days" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run trends.google.com/list_trending_searches# with {"country":"US","category":"all","active_only":false,"max_results":100,"time_window":"past_7_days"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "properties": { "country": { "type": "string", "default": "United States", "description": "Country name or two-letter code, for example United States or US." }, "category": { "type": "string", "default": "all", "description": "Trend category in words, for example sports, entertainment, business and finance, technology, politics, health, or all." }, "active_only": { "type": "boolean", "default": false, "description": "Show only searches still trending, for example true." }, "max_results": { "type": "integer", "default": 25, "maximum": 100, "minimum": 1, "description": "Maximum number of trends to return, for example 25." }, "time_window": { "enum": [ "past_4_hours", "past_24_hours", "past_48_hours", "past_7_days" ], "type": "string", "default": "past_24_hours", "description": "How far back to look, for example past_24_hours." } }}Output schema
{ "type": "object", "required": [ "trends" ], "properties": { "trends": { "type": "array", "items": { "type": "object", "properties": { "page_link": { "type": "string" }, "search_term": { "type": "string" }, "still_active": { "type": "boolean" }, "search_volume": { "type": [ "string", "null" ] }, "news_headlines": { "type": "array", "items": { "type": "object", "properties": { "link": { "type": "string" }, "title": { "type": "string" }, "publisher": { "type": [ "string", "null" ] } } } }, "related_searches": { "type": "array", "items": { "type": "string" } }, "started_trending": { "type": [ "string", "null" ] }, "search_volume_number": { "type": [ "integer", "null" ] } } } } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
trends.google.com/list_trending_searches- Returns
- search term, volume, start time, active flag, related searches, news headlines, Trends link
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method trends.google.com/list_trending_searches with the inputs above.
Ask your agent
- What are the top trending searches in the United States right now for sports over the past 24 hours?
- Show me only the searches still trending in Japan in the technology category, limit to 10 results.
- Which entertainment topics are blowing up on Google in the UK over the past 7 days?
- I need a list of the 15 biggest trending searches in Canada for business and finance from the last 4 hours, including their news headlines.
- Give me the current active trends in Brazil for health topics over the past 48 hours, with related searches for each.
See more
All Google methodsReturns top and rising related searches and topics for a term on Google Trends, for a country or US state and time range.
trends.google.com/get_related_searchesShows where a search term has the highest relative Google Trends interest, by country worldwide or by region within a country. Scores run from 0 to 100.
trends.google.com/get_interest_by_regionLists the current top Google News stories, overall or for one topic, in a chosen country and language edition.
news.google.com/list_top_storiesCompares Google Trends search interest for one to five terms over a time range, with average scores and a dated timeline. Scores are relative within the comparison.
trends.google.com/get_interest_over_timeLists ranked Android apps or games from the Google Play top free, top paid or top grossing chart for a country and category.
play.google.com/list_top_chartsLists major stock market indexes on Google Finance with their current levels, changes and quote times. Quotes may be delayed, and indexes Google does not show are left out.
google.com/list_market_indexesFinds recent Google News articles about a company, person or topic for a country and language, in Google News order, optionally within a time window, with each article's publisher link resolved.
news.google.com/search_newsGets Google Search autocomplete suggestions for words typed so far, in Google's order, for a chosen country and language.
google.com/get_search_suggestions