curl --request POST \
--url https://api.scrapeunblocker.com/trends/google-trends \
--header 'x-scrapeunblocker-key: <api-key>'import requests
url = "https://api.scrapeunblocker.com/trends/google-trends"
headers = {"x-scrapeunblocker-key": "<api-key>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {'x-scrapeunblocker-key': '<api-key>'}};
fetch('https://api.scrapeunblocker.com/trends/google-trends', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Scrape Google Trends (interest over time, by region, related queries)
Compares 1-5 keywords on Google Trends and returns the data behind the explore page as JSON: interestOverTime (one point per time bucket with a 0-100 value per keyword, ISO date, timestamp, isPartial), averages, interestByRegion (geoCode, geoName, values per keyword), and per keyword relatedQueries and relatedTopics (opt-in via sections), each with top and rising lists. Filter with geo (worldwide, country, region or US metro), timeframe (presets such as ‘today 12-m’ or a custom date range), category and property (web, images, news, youtube, shopping). Use sections to fetch only what you need. Billed as one request per keyword compared.
curl --request POST \
--url https://api.scrapeunblocker.com/trends/google-trends \
--header 'x-scrapeunblocker-key: <api-key>'import requests
url = "https://api.scrapeunblocker.com/trends/google-trends"
headers = {"x-scrapeunblocker-key": "<api-key>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {'x-scrapeunblocker-key': '<api-key>'}};
fetch('https://api.scrapeunblocker.com/trends/google-trends', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Authorizations
Your ScrapeUnblocker API key. Apply on every request.
Query Parameters
1-5 search terms to compare, comma-separated, e.g. 'coffee,tea'. A Knowledge Graph topic id such as '/m/0dl567' also works.
Where: empty = worldwide, an ISO-2 country ('US'), a region ('US-CA') or a US metro ('US-CA-807').
Time range: now 1-H, now 4-H, now 1-d, now 7-d, today 1-m, today 3-m, today 12-m, today 5-y, all, or a custom 'YYYY-MM-DD YYYY-MM-DD' (hourly for the last 7 days: 'YYYY-MM-DDTHH YYYY-MM-DDTHH').
Google Trends category id (0 = all categories, e.g. 71 = Food & Drink, 5 = Computers & Electronics).
x >= 0Which Google search to measure: web, images, news, youtube, shopping.
Language of labels (region names, topic titles), e.g. 'en-US', 'de', 'fr'.
Timezone offset in minutes that day/hour buckets align to (Trends' convention: 300 = UTC-5, -60 = UTC+1). Default 0 = UTC.
-840 <= x <= 840Level of the interest-by-region map: country, region, city, dma. Default = Trends' own choice (countries worldwide, regions in a country).
Include regions with low search volume in the region map.
What to fetch: a comma list of interest_over_time, interest_by_region, related_queries, related_topics, or 'all'. Fewer sections = faster. related_topics is opt-in (Google often returns it empty).
Exit-IP country (ISO-2). Optional - by default an ISP exit outside the US and Europe is used; results follow geo, not the exit IP.
Response
JSON with interestOverTime, interestByRegion, relatedQueries and relatedTopics.