Google Trends API · Endpoint
Google Trends Interest Over Time API
Compare interest in one or two search terms or topics over the past 12 months or 5 years, worldwide or in one country, as Google's 0 to 100 scores.
- 1 credit per call
- Failed calls are free
- Updated
- google_trends.interest.over_time
{ "results": [ { "formatted_time": "", "is_partial": null, "time": "1759017600", "has_data": [ true, true ], "values": [ 70, 33 ] }, { "formatted_time": "", "is_partial": null, "time": "1759622400", "has_data": [ true, true ], "values": [ 61, 33 ] } ]}
| # | Formatted time | Time |
|---|---|---|
| 1 | 1759017600 | |
| 2 | 1759622400 | |
| 3 | 1760227200 |
What you send
The input
object of the request, with every field the endpoint accepts.
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
| terms | array<string> | yes | One or two search terms or topic IDs to compare, such as ["coffee", "tea"]. | ["coffee","tea"] |
| geo | string | no | A two-letter country code such as US or IN. Leave it empty for worldwide. | US |
| language | string | no | The language for topic names, such as en-US. | en-US |
| period | string | no | The time window: today 12-m for the past year, today 5-y for the past five years. | 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[].formatted_time | string | The period as Google Trends labels it. | |
| results[].has_data | array | Whether Google Trends has data for this point. | true, true |
| results[].is_partial | null | Whether the period is still in progress. | null |
| results[].time | string | The start of the period, as a Unix timestamp in seconds. | 1759017600 |
| results[].values | array | Search interest for each compared term, from 0 to 100. | 70, 33 |
| results | array | The data points. | 3 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.over_time", "input": { "geo": "US", "language": "en-US", "period": "today 12-m", "terms": [ "coffee", "tea" ] }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "google_trends.interest.over_time", "input": { "geo": "US", "language": "en-US", "period": "today 12-m", "terms": [ "coffee", "tea" ] }}''')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.over_time", "input": { "geo": "US", "language": "en-US", "period": "today 12-m", "terms": [ "coffee", "tea" ] }}),});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, compare Google search interest in coffee and tea in the US over the past 12 months. Which one is searched more, and in which weeks did each peak?
More from the Google Trends API
Google Trends Interest Over Time API FAQ
The short answers. The docs have the long ones.
How much does the Google Trends Interest Over Time 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 terms. 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.over_time, 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.