Google
Google trends by region API
Get Google Trends search interest by region. Call the Google trends by region API for JSON. 1 credit per call. Every call returns the same flat shape.
POST
Get Google Trends search interest by region
Returns Google Trends search interest by region.
Request
queries is required.
Response
If successful, the response body contains the standard envelope.data.results[] contains the regions, each with one value for each query.
The following example is a real response, truncated: each list shows one item and long strings are cut.
For every field, see the response schema on this page.
Optional parameters
Billing
Each successful request consumes 1 credit, regardless of the number of items returned. Requests that fail, or that return no items, are not billed.Pagination
This method is not paginated. A single request returns the complete result.Related methods
- Google Trends interest over time: Accepts the same
queries. Returns Google Trends search interest over time, newest first, with one value per query. - Google Trends related searches: Accepts one of the same queries as
query. Returns related searches for a keyword.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Required array length:
1 - 5 elementsRequired string length:
1 - 100ISO 3166-1 alpha-2 country code, e.g. us. Any case is accepted.
Pattern:
^[A-Za-z]{2}$Google Trends' own time range.
Available options:
pastHour, past4Hours, pastDay, past7Days, past30Days, past90Days, past12Months, past5Years, since2004 Google Trends' own search type: web, images, news, shopping or youtube.
Available options:
web, images, news, shopping, youtube Google Trends' own top-level category.
Available options:
artsEntertainment, autosVehicles, beautyFitness, booksLiterature, businessIndustrial, computersElectronics, finance, foodDrink, games, health, hobbiesLeisure, homeGarden, internetTelecom, jobsEducation, lawGovernment, news, onlineCommunities, peopleSociety, petsAnimals, realEstate, reference, science, shopping, sports, travel Available options:
country, region, metro