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 available related topics. Each result is a keyword or comparison report; a requested section may be absent.

Choose this Actor when you need available Google Trends sections for 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).

Try a ready-to-run comparison

Compare n8n and Zapier in the US. Open the example, check the Pricing tab and maximum charge, then run one comparison before expanding your keyword list. Inspect status and the sections your workflow requires in Output; export JSON or CSV.

On September 20, 2026, build 0.0.6 returned 1 successful report in 15 seconds, with 54 time-series entries, 51 region entries and related-query data. relatedTopics was absent in that comparison despite being requested. This is a dated sample, not a completeness or speed guarantee.

Weekly brand comparison

Save a task with the same comparison keywords, country, category, search property and time window, then select a weekly schedule. Store each report with its run date and input settings in your database or automation workflow. Compare keywords from the same report to preserve their shared scale.

Treat missing sections as missing data, not zero interest. Exclude partial time buckets from completed-period comparisons. A rolling time window can change the normalization, so do not interpret separately normalized 0–100 values as absolute traffic growth. Review the first reports before scaling to more keyword groups.

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). Requested sections may be absent; check output before relying on them. 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.