Google Trends Scraper: Interest, Rising & Regional

Here is one real result, with every field the actor returns:

{
  "keyword": "bitcoin",
  "geo": "US",
  "timeframe": "today 12-m",
  "category": 0,
  "gprop": "web",
  "interestOverTime": [
    { "date": "Aug 10, 2025", "timestamp": 1754784000, "value": 36 },
    { "date": "Aug 17, 2025", "timestamp": 1755388800, "value": 29 },
    { "date": "Aug 24, 2025", "timestamp": 1755993600, "value": 29 }
  ],
  "averageInterest": 35.7,
  "peak": { "value": 100, "date": "Feb 1, 2026" },
  "risingQueries": [
    { "query": "how to buy bitcoin safely", "value": 15050, "formattedValue": "Breakout", "risingLabel": "Breakout" },
    { "query": "spacex stock", "value": 1250, "formattedValue": "+1,250%", "risingLabel": "+1,250%" }
  ],
  "topQueries": [
    { "query": "bitcoin price", "value": 100, "formattedValue": "100", "risingLabel": null },
    { "query": "bitcoin today", "value": 19, "formattedValue": "19", "risingLabel": null }
  ],
  "relatedTopics": [],
  "regionalInterest": [
    { "geoCode": "US-WY", "geoName": "Wyoming", "value": 100 },
    { "geoCode": "US-NV", "geoName": "Nevada", "value": 48 },
    { "geoCode": "US-KS", "geoName": "Kansas", "value": 45 }
  ],
  "aiTrendSummary": "Interest in Bitcoin has been declining over the past few weeks, with a recent average interest of 35.7. The peak was recorded on February 1, 2026 at a value of 100.",
  "aiMomentum": "falling",
  "observedAt": "2026-08-15T03:26:20.823Z",
  "error": null
}

The most complete Google Trends scraper available. It returns the full interest-over-time series plus the rising and top related queries, related topics and the per-region breakdown for each keyword, adds derived average and peak fields, and gives you five inputs (geo, timeframe, category, Google property, up to five keywords) to target exactly the trend you need.

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting
• More scrapers at scrapers.lat

What it does

Give it up to five keywords and it returns, for each one:

• Interest over time: the full normalized 0-100 search-interest series (weekly or the resolution Google uses for your timeframe), with a date and unix timestamp on every point.
• Average and peak: the mean interest across the window and the peak value with its date, computed for you.
• Rising queries: the searches growing fastest alongside your keyword, including Breakout and percentage-growth labels.
• Top queries: the most-searched related queries, ranked 0-100.
• Related topics: Google entity topics related to the keyword when Google returns them.
• Regional interest: the per-state or per-country breakdown, each region scored 0-100.
• AI trend summary (optional): a short plain-language summary and a momentum label (rising, falling, stable or volatile).

It works for any geo (worldwide, a country, or a sub-region), any timeframe from the last hour to the last five years, any Google Trends category, and across Web, News, YouTube, Image and Shopping search. Unlike thin wrappers that break when a single library endpoint changes, this actor performs the real Google Trends token handshake per keyword and degrades gracefully: if one keyword has no data it is reported without a charge and the rest of the run continues.

Quickstart

Real input example:

{
  "keywords": ["bitcoin", "ethereum"],
  "geo": "US",
  "timeframe": "today 12-m",
  "gprop": "web",
  "withRelated": true,
  "withRegional": true,
  "withAiSummary": true
}

Each keyword becomes one row in the dataset. Export the results as JSON, CSV or Excel from the run's dataset.

Input reference

Name	Type	Required	Description	Example
keywords	array	yes	Up to 5 search terms. Each returns its own independent 0-100 series and related data.	["bitcoin", "ethereum"]
geo	string	no	Two-letter country code or sub-region code. Empty means Worldwide.	US, GB, US-CA
timeframe	string	no	Google Trends time range.	today 12-m, now 7-d, today 5-y, all
category	integer	no	Google Trends category id to narrow the topic. 0 means all.	7 (Finance)
gprop	string	no	Google surface to measure: web, news, youtube, images, shopping.	web
withRelated	boolean	no	Capture rising and top related queries plus related topics. Paid plans only. Default true.	true
withRegional	boolean	no	Capture the per-region interest breakdown. Paid plans only. Default true.	true
withAiSummary	boolean	no	Add an AI summary and momentum label per keyword. Paid plans only. Default false.	false
residentialProxy	boolean	no	Route through residential IPs instead of the default datacenter pool.	false
proxyConfiguration	object	no	Proxy settings. Defaults to Apify datacenter proxy.	{ "useApifyProxy": true }

Output reference

Name	Type	Description
keyword	string	The search term this record covers.
geo	string	Geo used (region code or "Worldwide").
timeframe	string	Time range used.
category	integer	Category id used.
gprop	string	Google property used (web, news, youtube, images, shopping).
interestOverTime	array	Series of { date, timestamp, value }, value normalized 0-100.
averageInterest	number	Mean interest across the window.
peak	object	{ value, date } of the highest interest point.
risingQueries	array	Fastest-growing related queries with formattedValue and risingLabel.
topQueries	array	Most-searched related queries, each scored 0-100.
relatedTopics	array	Related Google entity topics when Google returns them (can be empty).
regionalInterest	array	Per-region breakdown: { geoCode, geoName, value }, value 0-100.
aiTrendSummary	string	Optional AI summary of the trend. Null unless the AI add-on is on.
aiMomentum	string	Optional momentum label: rising, falling, stable, volatile.
observedAt	string	ISO timestamp when the record was captured.
error	string	Populated only on a failed keyword; that row is never charged.

Example output record

{
  "keyword": "ethereum",
  "geo": "US",
  "timeframe": "today 12-m",
  "category": 0,
  "gprop": "web",
  "interestOverTime": [
    { "date": "Aug 10, 2025", "timestamp": 1754784000, "value": 68 },
    { "date": "Aug 17, 2025", "timestamp": 1755388800, "value": 54 }
  ],
  "averageInterest": 40.6,
  "peak": { "value": 100, "date": "Aug 10, 2025" },
  "risingQueries": [
    { "query": "ethereum etf", "value": 4900, "formattedValue": "+4,900%", "risingLabel": "+4,900%" }
  ],
  "topQueries": [
    { "query": "ethereum price", "value": 100, "formattedValue": "100", "risingLabel": null }
  ],
  "relatedTopics": [],
  "regionalInterest": [
    { "geoCode": "US-NY", "geoName": "New York", "value": 100 }
  ],
  "aiTrendSummary": "Interest in Ethereum has been declining over the past few months, with recent values well below the August 2025 peak.",
  "aiMomentum": "falling",
  "observedAt": "2026-08-15T03:26:22.400Z",
  "error": null
}

Run via API and CLI

Start a run with the Apify API:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~google-trends-scraper/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "keywords": ["bitcoin", "ethereum"], "geo": "US", "timeframe": "today 12-m", "gprop": "web" }'

Or with the Apify CLI:

apify call scrapers_lat/google-trends-scraper \
  --input '{ "keywords": ["bitcoin"], "geo": "US", "timeframe": "today 12-m" }'

Fetch results

$curl "https://api.apify.com/v2/datasets/DATASET_ID/items?clean=true&format=json&token=YOUR_TOKEN"

Swap format=json for format=csv or format=xlsx to download a spreadsheet.

Billing and limits

This actor is pay per result. You are billed per keyword record, not per run.

Event	Price (USD)	When it is charged
result	0.012	One keyword series returned (interest over time, average, peak).
related	0.008	Rising and top queries plus topics returned for a keyword.
regional	0.008	Per-region breakdown returned for a keyword.
ai_trend_summary	0.012	AI summary and momentum returned for a keyword.

• No charge on failure. A keyword with no data is written as an error row and is never billed.
• Add-ons are opt-in and paid-plan only. related, regional and ai_trend_summary are disabled for free Apify plans; free runs return the interest-over-time series only.
• Free plan cap. Free Apify accounts are capped at 10 records per run (this actor takes up to 5 keywords, so all fit).
• Spend cap. Set maxTotalChargeUsd on the run and the actor stops emitting billable records once the cap is reached.

FAQ and troubleshooting

Why is relatedTopics sometimes empty? Google's related-topics widget frequently returns no entries for a keyword even when related queries exist. When Google returns topics, the field is populated; otherwise it is an empty array. Related queries and regional data are the primary related signals.

Can I compare keywords head to head? Each keyword is measured independently on its own 0-100 scale, so you get a clean series per term rather than one keyword normalized against another. Pass several keywords in one run to gather them together.

Which timeframes are supported? Anything Google Trends accepts, for example now 1-H, now 7-d, today 1-m, today 3-m, today 12-m, today 5-y, all.

Do I need an API key or login? No. The actor collects public Google Trends data with no account.

A keyword returned an error row. Google rate-limits by IP. The actor rotates proxy sessions and retries automatically; a keyword that still fails is reported without a charge. Re-running usually resolves transient rate limits.

More scrapers at scrapers.lat

Browse the full catalog of company registry, KYB, licensing, finance and market-signal scrapers at scrapers.lat.