Google Trends

Get Interest by Region

get/google-trends/interest-by-region

Request

  • Base URL: https://scrappa.co/api
  • URL: https://scrappa.co/api/google-trends/interest-by-region
  • Auth: API key in header X-API-KEY

Query parameters

qstring required

The search keyword to analyze (e.g., "coffee"). To compare keywords, pass up to 5 terms separated by commas (e.g., "coffee,tea"). Each term can be up to 100 characters.

geostring nullable

Geographic location code (e.g., "US", "DE", "GB"). Leave empty for the worldwide list (250 countries).

region'REGION' | 'COUNTRY' | 'null' nullable

REGION (default) returns sub-national regions for the geo (e.g., 51 states for US). COUNTRY returns the worldwide country list and requires an empty geo.

datestring nullable

Time period: a relative token (today 12-m, today 3-m, today 1-m, now 1-d, now 7-d, now 4-h) or an absolute range (YYYY-MM-DD YYYY-MM-DD).

catinteger nullable

Google Trends category id (0 for all categories)

gprop'' | 'images' | 'news' | 'youtube' | 'froogle' | 'null' nullable

Search property: images, news, youtube or froogle (empty for web search)

tzinteger nullable

Timezone offset in minutes

hlstring nullable

Language code for results (e.g., en, en-US, de-DE)

Response

Interest by region data retrieved successfully

queriesstring[] required
geostring required
datestring required
response_time_msinteger required

Changes

No recorded changes to this operation across all 9 revisions of this API.