Google Trends API · Endpoint
Google Trends Interest by Region API
See where a search term or topic is searched most, region by region, scored 0 to 100.
- 1 credit per call
- Failed calls are free
- Updated
- google_trends.interest.by_region
{ "results": [ { "geo_code": "US-WY", "geo_name": "Wyoming", "has_data": null, "value": 100 }, { "geo_code": "US-KS", "geo_name": "Kansas", "has_data": null, "value": 41 } ]}
| # | Geo code | Geo name | Value |
|---|---|---|---|
| 1 | US-WY | Wyoming | 100 |
| 2 | US-KS | Kansas | 41 |
What you send
The input
object of the request, with every field the endpoint accepts.
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
| term | string | yes | The search term or topic ID. | coffee |
| geo | string | no | A two-letter country code to see its regions. Leave it empty to compare countries. | US |
| language | string | no | The language for names, such as en-US. | en-US |
| period | string | no | The time window: today 12-m or today 5-y. | today 12-m |
Fields it returns
What each record in the response holds, with the values from the sample above.
| Field | Type | What it is | Example |
|---|---|---|---|
| results[].geo_code | string | The region's code, such as US-WY for Wyoming. | US-WY |
| results[].geo_name | string | The region's name. | Wyoming |
| results[].has_data | null | Whether Google Trends has data for this point. | null |
| results[].value | integer | Search interest from 0 to 100, where 100 is the peak. | 100 |
| results | array | The data points. | 2 records |
Call it from your code, or ask your agent
Set UPSCRAPE_API_KEY to your key and copy a working request.
curl --request POST \ --url https://data.upscrape.com/execute \ --header "Authorization: Bearer $UPSCRAPE_API_KEY" \ --header "Content-Type: application/json" \ --header "Prefer: wait=30" \ --data '{ "capability": "google_trends.interest.by_region", "input": { "geo": "US", "language": "en-US", "period": "today 12-m", "term": "coffee" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "google_trends.interest.by_region", "input": { "geo": "US", "language": "en-US", "period": "today 12-m", "term": "coffee" }}''')response = requests.post( "https://data.upscrape.com/execute", headers={ "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}", "Content-Type": "application/json", "Prefer": "wait=30", }, json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))
const response = await fetch("https://data.upscrape.com/execute", { method: "POST", headers: { "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`, "Content-Type": "application/json", "Prefer": "wait=30", }, body: JSON.stringify({ "capability": "google_trends.interest.by_region", "input": { "geo": "US", "language": "en-US", "period": "today 12-m", "term": "coffee" }}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
https://data.upscrape.com/mcp
With Upscrape, get the Google Trends interest by region for geo "US", language "en-US" and period "today 12-m". Tell me what it costs before you run it, then show the results as a table.
More from the Google Trends API
Google Trends Interest by Region API FAQ
The short answers. The docs have the long ones.
How much does the Google Trends Interest by Region API cost?
1 credit per successful call, shown before it runs. You buy credits once, and paid credits never expire.
What do I send?
Send term. The input fields below list every option with its type and limits.
Do I need a Google Trends login?
No. It reads public Google Trends data; nothing runs on your account.
Can my AI agent call it?
Yes, over MCP: the agent finds google_trends.interest.by_region, checks its price and runs it with the same credits as the REST API.
Your first Google Trends call is free.
Up to 100 free credits to start, no card needed.