Google search and market data

Google Trends Interest by Region Scraper

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.

$2.00per 1,000 · Keyword mapped

One keyword delivered with its full interest-by-region breakdown. Keywords without data are never charged.

Call it from your code

curl
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"}'
python
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")
javascript
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");

Use it in an agent

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.

mcp url
https://mcp.apify.com?tools=steadydata/google-trends-regions

# the tool arrives in your agent as steadydata--google-trends-regions

Input

FieldTypeNameWhat it does
keywords
required
array of stringKeywordsSearch 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.
geostringCountry (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.
resolutionstringResolution within a countryUsed only when a country is set: REGION gives states or provinces, CITY gives cities. Worldwide is always by country.
timeframestringTimeframeThe period the interest is measured over.
includeZeroRowsbooleanInclude regions without dataGoogle 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.
languagestringLanguageLanguage of the region names (hl), e.g. en-US, nl, de.

What you get back

output schema, one object per delivered row
{
  "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
}
FieldTypeWhen it is filled
keywordstring, null
geostring, null
resolutionstring, null
timeframestring, null
regionCountinteger, null
topRegionCodestring, null
topRegionNamestring, null
regionsarray, null
statusstring, nullEither 'ok' or 'error'. An error row carries errorCode and error, and leaves the data fields empty; it is never charged.
inputstring, nullThe input this row was built from, so a row can always be traced back.
errorCodestring, nullFilled on an error row only; a delivered row leaves it empty.
errorstring, nullFilled on an error row only; a delivered row leaves it empty.

Related datasets

Already 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.

Open the Apify page