Google Trends API reference

google_trends.trending.daily

Google's daily trending searches for a country or region, with approximate traffic band, time and news links.

Google Trends Daily Search Trends by Region API: overview and live sample

At a glance

Endpoint ID: google_trends.trending.daily
Price: 1 credit per call; failed calls are free
Runs for up to: 30 seconds
Request: POST /execute; Run an endpoint
MCP tool when pinned: google_trends__trending__daily; Pin tools
OpenAPI: openapi.json; Download

Request

Send the endpoint ID as capability and its fields as input. Set UPSCRAPE_API_KEY to your key first.

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.trending.daily",  "input": {    "country": "US",    "region": "CA"  }}'

import jsonimport osimport requestspayload = json.loads(r'''{  "capability": "google_trends.trending.daily",  "input": {    "country": "US",    "region": "CA"  }}''')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.trending.daily",  "input": {    "country": "US",    "region": "CA"  }}),});if (!response.ok) {  throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));

Input

Field	Type	Required	What it does	Example
`country`	string	yes	ISO 3166-1 alpha-2 country code, case-insensitive (for example US or IN). The daily feed serves about half of all countries; others return invalid_input naming country.	US
`region`	string	no	Optional subdivision inside country, as its ISO 3166-2 code (US-CA) or the part after the dash (CA), case-insensitive. Only subdivisions the feed serves are accepted; others return invalid_input naming region and never fall back to the whole country. Omit for the whole country.	CA

Response

A finished call answers with HTTP 200; the data is in results[0].data, and billing.credits_charged is what it cost. A call still running after the wait answers 202: see jobs and results.

This is results[0].data from a real run:

results[0].data

{  "geo": "US-CA",  "items": [    {      "title": "winter weather forecast",      "published_at": "2026-10-16T21:10:00Z",      "approx_traffic": "500+",      "approx_traffic_min": 500,      "picture_source": "CNN",      "news_items": [        {          "title": "A super El Niño winter is coming and the first official forecast is in",          "source": "CNN",          "url": "https://www.cnn.com/2026/10/15/weather/winter-outlook-super-el-nino"        },        {          "title": "Cincinnati winter forecast: What strong El Niño conditions signal",          "source": "WKRC",          "url": "https://local12.com/weather/weather-articles/cincinnati-winter-forecast-what-strong-el-nino-conditions-signal-john-gumm-snowfall-temperatur…"        }      ]    },    {      "title": "h-1b visa",      "published_at": "2026-10-16T21:10:00Z",      "approx_traffic": "100+",      "approx_traffic_min": 100,      "picture_source": "Politico",      "news_items": [        {          "title": "Microsoft’s president warns White House against skilled immigration crackdown",          "source": "Politico"        },        {          "title": "India calls JD Vance's comments about immigrants 'deeply offensive'",          "source": "CNBC",          "url": "https://www.cnbc.com/2026/10/09/india-us-immigration-h1b-visa.html"        }      ]    }  ]}

Fields

Field	Type	Example
`items[].news_items[].title`	string	A super El Niño winter is coming and the first official forecas…
`items[].title`	string	winter weather forecast
`items[].published_at`	string	2026-10-16T21:10:00Z
`items[].approx_traffic`	string	500+
`items[].approx_traffic_min`	integer	500
`items[].news_items`	array	3 records
`items[].news_items[].source`	string	CNN
`items[].news_items[].url`	string	https://www.cnn.com/2026/10/15/weather/winter-outlook-super-el-…
`items[].picture_source`	string	CNN
`geo`	string	US-CA
`items`	array	3 records

If a call fails

A failed call costs nothing. The response carries an error.code you can branch on; Errors and retries lists every code and which ones to retry.

Other Google Trends endpoints

Something missing or unclear? Ask the team that builds the Google Trends endpoints.