Google Trends API · Endpoint
Google Trends Topics API
Find Google topic IDs for a word, such as Coffee the beverage, to compare a topic rather than one exact spelling.
- 1 credit per call
- Failed calls are free
- Updated
- google_trends.topics.autocomplete
{ "results": [ { "title": "Coffee", "topic_id": "/m/02vqfm", "type": "Beverage" }, { "title": "Coffee bean", "topic_id": "/m/05bzrs", "type": "" } ]}
| # | Title | Type | Topic id |
|---|---|---|---|
| 1 | Coffee | Beverage | /m/02vqfm |
| 2 | Coffee bean | /m/05bzrs | |
| 3 | Coffee | Plant | /g/121y048j |
| 4 | Cafe | /m/020fb2 |
What you send
The input
object of the request, with every field the endpoint accepts.
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
| query | string | yes | The word to look up, such as coffee. | coffee |
| language | string | no | The language for topic names, such as en-US. | en-US |
| limit | integer | no | How many topics to return. | 10 |
Fields it returns
What each record in the response holds, with the values from the sample above.
| Field | Type | What it is | Example |
|---|---|---|---|
| results[].title | string | The topic's name. | Coffee |
| results[].topic_id | string | Google's ID for the topic, usable in place of a search term. | /m/02vqfm |
| results[].type | string | The kind of topic, such as Beverage. | Beverage |
| results | array | The data points. | 4 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.topics.autocomplete", "input": { "language": "en-US", "limit": 10, "query": "coffee" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "google_trends.topics.autocomplete", "input": { "language": "en-US", "limit": 10, "query": "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.topics.autocomplete", "input": { "language": "en-US", "limit": 10, "query": "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 topics for language "en-US" and query "coffee". Tell me what it costs before you run it, then show the results as a table.
More from the Google Trends API
The same data from other platforms
Instahyre JobsAutocomplete companies
ZeptoPlace autocompleteGoogle Trends Topics API FAQ
The short answers. The docs have the long ones.
How much does the Google Trends Topics 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 query. 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.topics.autocomplete, 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.