Google Trends Scraper & API — Rising Queries, Regions

Get Google Trends data for any keyword as JSON, CSV or Excel: interest over time, interest by region (country, state, city or US metro), related queries (top and rising, including "Breakout") and related topics. One keyword = one complete report row.

Choose this Actor when you need all four Google Trends sections for a list of keywords in one run, on a schedule, without handling Google's rate limits yourself — and you only want to pay for reports that actually came back.

Not the right fit when you need absolute search volumes (Google Trends publishes relative 0–100 interest only) or the "Trending now" daily feed (this Actor analyses keywords you supply).

Use cases

• SEO and content planning — find rising queries and Breakout terms before they peak.
• Product and market research — compare brands or products over time and across countries.
• E-commerce — see seasonality in Google Shopping searches (searchProperty: "froogle").
• YouTube and news topics — switch searchProperty to youtube or news.
• Analytics and investing — use relative search interest as an alternative data signal.
• Automation — schedule weekly runs and push rows to Google Sheets, Slack, Make, Zapier or n8n.

How failures are handled

Google Trends rate-limits aggressively. On HTTP 429 or a server error the Actor switches to a new session and a new residential IP and backs off exponentially before retrying. A keyword that still fails after all retries is saved with status: "error" and an error message so you can see it — and it is not charged.

Input example

{
  "keywords": ["n8n", "zapier"],
  "compareKeywords": true,
  "geo": "US",
  "timeRange": "today 12-m",
  "searchProperty": "",
  "regionResolution": "REGION",
  "includeRelatedQueries": true,
  "includeRelatedTopics": true
}

Input	What it does	Example
keywords	Terms to look up (required)	["n8n", "zapier"]
compareKeywords	Put up to 5 keywords on one shared scale, like the Trends compare view	true
geo	Country or region code; empty = worldwide	US, TW, US-CA
timeRange	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	today 12-m
customTimeRange	Overrides timeRange	2025-01-01 2025-06-30
searchProperty	empty = web, images, news, froogle (Shopping), youtube	news
category	Google Trends category ID, 0 = all	0
regionResolution	COUNTRY, REGION, CITY, DMA, or empty = automatic	REGION
includeInterestOverTime / includeInterestByRegion / includeRelatedQueries / includeRelatedTopics	Switch sections on or off	true
language	Language for topic names	en-US, zh-TW

Residential proxy is on by default; Google blocks datacenter IPs quickly.

Output example (shortened)

{
  "keywords": ["n8n"],
  "geo": "US",
  "timeRange": "today 12-m",
  "property": "web",
  "status": "ok",
  "interestOverTime": [
    { "date": "…", "timestamp": 1757808000, "values": { "n8n": 41 }, "isPartial": false }
  ],
  "interestByRegion": [
    { "geoCode": "US-CA", "geoName": "California", "values": { "n8n": 100 } }
  ],
  "relatedQueries": {
    "top": [{ "query": "…", "value": 100, "formattedValue": "100" }],
    "rising": [{ "query": "…", "value": 4250, "formattedValue": "Breakout" }]
  },
  "relatedTopics": {
    "top": [{ "title": "…", "type": "Topic", "mid": "…", "value": 100, "formattedValue": "100" }],
    "rising": []
  }
}

Pricing

$5 per 1,000 successful keyword reports.

One report = one keyword (or one compare group of up to 5 keywords) with all sections you switched on. Failed keywords are free. Platform usage and residential proxy are included — nothing is billed on top. Example: 250 keywords = $1.25. Set a maximum cost per run for a hard cap.

FAQ

Are the values search volumes? No. Google Trends reports relative interest (0–100) within the chosen time range and location.

Why do numbers differ slightly between runs? Google samples its data; small differences are normal, especially for low-volume keywords.

What does "Breakout" mean? A related query grew by more than 5,000% in the period; value holds the growth number and formattedValue shows "Breakout".

Do compared keywords cost more? No. A compare group of up to 5 keywords is one report.

Can I get city or US metro (DMA) data? Yes — set regionResolution to CITY or DMA.

Is scraping Google Trends legal? The Actor collects aggregated, anonymous statistics that Google publishes publicly and no personal data. You are responsible for using the data in line with applicable laws and Google's terms.

Something not working? Open an issue on the Issues tab and include your run ID.