Google search and market data
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.
# one call, results straight back curl -X POST "https://api.apify.com/v2/acts/steadydata~google-trends-regions/run-sync-get-dataset-items?token=$APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ ... }'
| Field | Name | What it does |
|---|---|---|
keywordsrequired | 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 | 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 | 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 | Timeframe | The period the interest is measured over. |
includeZeroRows | 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 | Language | Language of the region names (hl), e.g. en-US, nl, de. |
| Field | Type |
|---|---|
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 |