Google

Google Trends

Get Google Trends interest-over-time and related-query data for a search term, or compare up to 5 terms on one 0-100 scale by comma-separating them. 1 credit for one term, 3 credits for a comparison. See Google Trending for real-time trending searches by region.

POST/api/v2/google/trends

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

querystringrequired

Search keyword (-> q). Comma-separate up to 5 terms to compare them; each timeline point then has one values[] entry per term, and each interest_by_region entry adds values[] with each term's share. GEO_MAP_0, RELATED_QUERIES and RELATED_TOPICS accept a single term only.

Example: ai agents

geostring

Location code (US, GB, US-CA). Worldwide when empty.

Example: US

hlstring

UI language.

Example: en

datestring

Time range (e.g. today 12-m).

Example: today 12-m

tzstring

Timezone offset in minutes.

data_typeenum<string>

Widget: TIMESERIES, GEO_MAP, GEO_MAP_0, RELATED_QUERIES, RELATED_TOPICS.

catstring

Category id (e.g. 71).

gpropenum<string>

Google property: images, news, youtube, froogle (empty = web).

regionenum<string>

Geo granularity: COUNTRY, REGION, DMA, CITY.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")
results = client.google.trends("ai agents", geo="US")
print(results)

Response

"q": "ai agents",

"geo": "US",

"hl": "en",

"date": "today 12-m",

"tz": "420"

"source": "",

"credits_used": 1,

"credits_remaining": 49

}