Google Trends Scraper: interest, regions, related queries, trending

Pull Google Trends data for any list of keywords, or today's trending searches by country.

What you get

Keyword mode: one result per keyword (up to 1000 keywords per run). Google scores each keyword from 0 to 100 against its own peak for the selected time and place. The Google Trends website comparison view uses one shared scale and accepts up to 5 keywords together. This actor requests each keyword separately. Each result includes:

• interest over time (timeline with dates and 0 to 100 values), plus average and peak date
• interest by region
• top and rising related queries
• top and rising related topics (when Google publishes them for the query; often empty for broad terms)
• a link to open the same view in Google Trends

Trending now mode: one result per trending search, with approximate traffic, start time and linked news stories.

How it handles errors

• Every request retries up to 6 times with jittered exponential backoff.
• On a rate limit (HTTP 429) or network error the IP session is retired and a new Apify Proxy IP is used.
• Each data block is fetched separately. If one block fails, you still get the rest and the result is marked partial: true with the reason in errors.
• A keyword that fails completely is never charged. It is listed in the RUN_SUMMARY record with the error.
• Bad input fails fast with a plain explanation.

Testing so far is small: 20 runs (about 210 results) on the developer's account. One 25-keyword run hit Google rate limits and recovered every keyword through retries and IP rotation. Larger volumes have not been tested yet.

Pricing

Item	Price
Per result (row)	$0.0006
Actor start fee	None
Partial rows	Charged as results
Failed or noData items	Not charged

$0.0006 per result. Platform usage is included. No start fee. Partial results (partial: true, some data blocks missing) are charged the full $0.0006. Failed keywords and keywords where Google has no data (too little search volume) are delivered with noData: true or listed in RUN_SUMMARY and are not charged. The run stops cleanly when your max charge limit is reached.

Check the Store pricing tab for the current price.

Input example

{ "mode": "keywords", "keywords": ["chatgpt", "gemini"], "geo": "US", "timeRange": "today 12-m" }

{ "mode": "trendingNow", "trendingGeos": ["US", "GB", "DE"] }

Time ranges: now 1-H, now 7-d, today 1-m, today 3-m, today 12-m, today 5-y, all, or 2024-01-01 2024-12-31.

Output example

{
  "type": "keyword",
  "keyword": "bitcoin",
  "geo": "US",
  "timeRange": "today 12-m",
  "interestOverTime": [{ "date": "2025-11-02T00:00:00.000Z", "formattedTime": "Nov 2 - 8, 2025", "value": 40, "isPartial": false }],
  "interestByRegion": [{ "geoCode": "US-WY", "geoName": "Wyoming", "value": 100 }],
  "relatedQueriesTop": [{ "query": "bitcoin price", "value": 100, "formattedValue": "100" }],
  "averageInterest": 38.2,
  "peakDate": "2026-01-11T00:00:00.000Z",
  "partial": false,
  "errors": []
}

FAQ

Does Google Trends have an official API?

Google has an alpha Trends API with limited access. This Actor gives you Trends data now, with no API key or approval needed.

Is there a free way to get Google Trends data?

The Google Trends website is free to browse. This Actor charges $0.0006 per result returned, with no start fee, and Apify's free plan credits cover small runs.

What data can I get?

Interest over time, interest by region (country, state, or city, depending on the geo code you set), related queries and related topics (top and rising), and daily trending searches by country.

Does Google Trends show search volume?

No. Google Trends shows relative interest on a 0 to 100 scale, where 100 is peak interest for the chosen time and place. The Actor returns those same values.

What is the difference between related queries and related topics?

Related queries are exact search phrases people also used. Related topics are broader entities grouped across languages and spellings.

How do I use Google Trends for keyword research?

Compare candidate keywords over time, check where demand is highest by region, then mine rising related queries for new content ideas. Each keyword in a run is scored on its own 0 to 100 scale, and a run accepts up to 1000 keywords. The public Tasks below preset each step.

Can I get trending searches every day?

Yes. Run the trending searches Task on an Apify schedule and send results to Google Sheets, Slack, or a webhook.

Am I charged if a run fails?

Failed and noData items are not charged. Partial rows are charged at $0.0006 each.

Can I call it from code?

Yes. Use the Apify API or the apify-client libraries for JavaScript and Python. See https://docs.apify.com/api/v2.

Ready-made Tasks

• Compare keywords on Google Trends interest over time
• Get Google Trends related queries for a keyword
• See today's Google trending searches by country
• Google Trends interest by region for a keyword

Related actors

• Bulk domain WHOIS, DNS, SSL, and tech stack in one call: WHOIS, DNS, SSL, and tech stack for the domains behind a brand.
• Subdomain Monitoring: watch new subdomains for brands you track.

Development

npm install
bun test
npx tsc --noEmit

Values are relative (0 to 100) as published by Google Trends. This actor uses only publicly available Trends pages.