Google Trends Interest By Region API
When a Google Trends search contains interest by region chart results, they are parsed and exist within the interest_by_region
array in the JSON output. Interest by region can contain geo
, coordinates
, location
, max_value_index
, value
, and extracted_value
.
Interest by region chart accepts only single query per search.
API Examples
API Parameters
data_type
Required
Parameter must be set to GEO_MAP_0
. (I.e., data_type=GEO_MAP_0
)
region
Optional
Parameter is used for getting more specific results when using "Compared breakdown by region" and "Interest by region" data_type charts. Other data_type charts do not accept region parameter. The default value depends on the geo location that is set. Available options:COUNTRY
- CountryREGION
- SubregionDMA
- MetroCITY
- City
Not all region options will return results for every geo location.
Example with q: coffee

{
"interest_by_region": [
{
"geo": "SG",
"location": "Singapore",
"max_value_index": 0,
"value": "100",
"extracted_value": 100
},
{
"geo": "AU",
"location": "Australia",
"max_value_index": 0,
"value": "87",
"extracted_value": 87
},
{
"geo": "NZ",
"location": "New Zealand",
"max_value_index": 0,
"value": "77",
"extracted_value": 77
},
...
]
}
Example with q: coffee
and region: CITY

{
"interest_by_region": [
{
"coordinates": {
"lat": 54.7582068,
"lng": -5.7115538
},
"location": "Whitehead",
"max_value_index": 0,
"value": "100",
"extracted_value": 100
},
{
"coordinates": {
"lat": 51.397643,
"lng": -2.299443
},
"location": "Bathford",
"max_value_index": 0,
"value": "97",
"extracted_value": 97
},
{
"coordinates": {
"lat": 50.415497,
"lng": -5.073719
},
"location": "Newquay",
"max_value_index": 0,
"value": "90",
"extracted_value": 90
},
...
]
}