Where in the world, or where in a country, a keyword is searched: Google Trends interest by region for up to 200 keywords per run. Worldwide gives up to 250 countries per keyword; a country code gives its regions or cities. One row per keyword, regions ranked 0 to 100.
One keyword delivered with its full interest-by-region breakdown. Keywords without data are never charged.
ACTOR=steadydata~google-trends-regions URL="https://api.apify.com/v2/acts/$ACTOR/run-sync-get-dataset-items" curl -X POST "$URL?token=$APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"keywords": ["bitcoin", "electric bike", "yoga"], "resolution": "REGION", "timeframe": "today 12-m"}'
import os, requests ACTOR = "steadydata~google-trends-regions" URL = f"https://api.apify.com/v2/acts/{ACTOR}/run-sync-get-dataset-items" rows = requests.post( URL, params={"token": os.environ["APIFY_TOKEN"]}, json={'keywords': ['bitcoin', 'electric bike', 'yoga'], 'resolution': 'REGION', 'timeframe': 'today 12-m'}, timeout=900, ).json() # every row carries a status; failures are records, not exceptions ok = [r for r in rows if r.get("status") == "ok"] print(len(ok), "rows delivered")
const ACTOR = "steadydata~google-trends-regions"; const url = `https://api.apify.com/v2/acts/${ACTOR}/run-sync-get-dataset-items` + `?token=${process.env.APIFY_TOKEN}`; const rows = await fetch(url, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({"keywords": ["bitcoin", "electric bike", "yoga"], "resolution": "REGION", "timeframe": "today 12-m"}), }).then((r) => r.json()); // one object per delivered row, same shape every time console.log(rows.filter((r) => r.status === "ok").length, "rows");
Point an MCP client at Apify's hosted server with this dataset in the tools list, or run our own server locally. The field explanations in the table below travel with the schema, so your agent reads them straight from the platform instead of from this page.
https://mcp.apify.com?tools=steadydata/google-trends-regions # the tool arrives in your agent as steadydata--google-trends-regions
| Field | Type | Name | What it does |
|---|---|---|---|
keywordsrequired | array of string | Keywords | Search terms, one per row. Each keyword is one input and one charged event; a keyword without enough search volume comes back as a free error record. |
geo | string | Country (empty = worldwide) | Leave empty for a worldwide breakdown by country. Give a two-letter country code (US, GB, NL, DE ...) for a breakdown within that country. |
resolution | string | Resolution within a country | Used only when a country is set: REGION gives states or provinces, CITY gives cities. Worldwide is always by country. |
timeframe | string | Timeframe | The period the interest is measured over. |
includeZeroRows | boolean | Include regions without data | Google lists every region, also those with too little search volume (value 0, no data). Off by default so the list holds only regions with a real score. |
language | string | Language | Language of the region names (hl), e.g. en-US, nl, de. |
{
"keyword": string | null,
"geo": string | null,
"resolution": string | null,
"timeframe": string | null,
"regionCount": integer | null,
"topRegionCode": string | null,
"topRegionName": string | null,
"regions": array | null,
"status": string | null,
"input": string | null,
"errorCode": string | null,
"error": string | null
}| Field | Type | When it is filled |
|---|---|---|
keyword | string, null | |
geo | string, null | |
resolution | string, null | |
timeframe | string, null | |
regionCount | integer, null | |
topRegionCode | string, null | |
topRegionName | string, null | |
regions | array, null | |
status | string, null | Either 'ok' or 'error'. An error row carries errorCode and error, and leaves the data fields empty; it is never charged. |
input | string, null | The input this row was built from, so a row can always be traced back. |
errorCode | string, null | Filled on an error row only; a delivered row leaves it empty. |
error | string, null | Filled on an error row only; a delivered row leaves it empty. |
Ads from Google's Ads Transparency Center per advertiser domain or advertiser id, per country or worldwide: creative id, advertiser name, preview image or preview URL, first and last shown dates and a link to the ad. Up to 200 advertisers per run. Pay only for delivered ads.
$1.40 per 1,000 · Ad listedGoogle's autocomplete suggestions for up to 500 seed keywords per run, per country and language, with optional a-to-z and question-word expansion for hundreds of long-tail keywords per seed. Ranked, with Google's relevance score and suggestion type. Pay only for delivered suggestions.
$0.35 per 1,000 · Suggestion listedFlight options from Google Flights for up to 200 searches per run: price, airlines, flight numbers, departure and arrival times, duration, stops and layover airports, aircraft and CO2 estimate, in Google's order. One-way or round trip, any cabin class and currency. Pay only for delivered flights.
$1.40 per 1,000 · Flight listedAlready using this one? Ratings are the first thing other buyers look at, and this dataset has none yet. If it does a job for you, a rating on its Apify page is the one thing that helps. It takes a minute and it is the only thing we ask for.