Skip to main content
POST
Get search interest by region
  • Endpoint: google.trends.regions
  • Returns: data has queries, regions.
  • Cost: 1 credit. Failed calls cost nothing.
  • Paging: No.

Example

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
queries
string[]
required
Required array length: 1 - 5 elements
Required string length: 1 - 100
country
string

ISO 3166-1 alpha-2 country code, e.g. us. Any case is accepted.

Pattern: ^[A-Za-z]{2}$
subdivision
string

A state or metro inside country, e.g. CA for California in us.

Pattern: ^[A-Z0-9]{1,3}(-[A-Z0-9]{1,3})?$
within
enum<string>
Available options:
hour,
day,
week,
month,
year,
all
from
string<date>
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
to
string<date>
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
category
integer
default:0
Required range: 0 <= x <= 9007199254740991
vertical
enum<string>
default:web
Available options:
web,
images,
news,
youtube,
shopping
language
string
default:en-US

BCP 47 language tag, e.g. en or pt-BR. Any case is accepted.

Pattern: ^[A-Za-z]{2,3}(?:[-_][A-Za-z0-9]{2,4})?$
resolution
enum<string>
Available options:
country,
region,
metro
includeLowVolume
boolean
default:false

Response

The data, and the credits this call used.

success
any
required
data
object
required
creditsUsed
integer
required
requestId
string
required