# Google Trends Scraper 📈 (results in seconds) (`tagadanar/google-trends-scraper`) Actor
Scrape Google Trends as clean JSON: interest over time, interest by region, related queries, keyword comparison and live Trending Now with real search volumes. No browser, no Puppeteer, no API key, just fast results for SEO research, market tracking and AI agents.
- **URL**: https://apify.com/tagadanar/google-trends-scraper.md
- **Developed by:** [Tagada Data](https://apify.com/tagadanar) (community)
- **Categories:** SEO tools, AI, News
- **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $1.40 / 1,000 keyword results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## Google Trends Scraper 📈 (fast, no browser)
**Scrape Google Trends data as clean JSON: interest over time, interest by region, related queries, keyword comparison and live trending searches.** Give it keywords and it hands back the full Google Trends breakdown in seconds, straight from the same endpoints the trends.google.com website itself uses, with no Puppeteer, no browser, no API key and no flaky UI automation.
Built for **SEO keyword research, content planning, market and brand tracking, trend monitoring, trading signals and AI agents** (REST API + MCP).
### Why this Google Trends scraper
Most Google Trends actors drive a headless Chrome through the website UI, which is slow, memory-hungry and easily broken whenever Google tweaks the page. This one requests the underlying JSON directly, so it's **faster, cheaper and more reliable**, and it adds **live Trending Now data with real search volumes** that browser scrapers don't expose:
- ⚡ It's **fast and cheap**: one keyword is just a handful of small JSON requests, so there's no Chrome instance burning through your compute units.
- 🎯 It's **complete**, covering interest over time, interest by region, related queries, up-to-5-keyword comparison and Trending Now, all in one actor.
- 🔁 It's **robust**, handling Google's cookie handshake and rate limits automatically, with proxy-session rotation whenever it hits a 429.
- 💸 And it's **priced to switch**: **$2 per 1,000 keywords**, no subscription.
### What you can do with it
- It's useful for **SEO and keyword research**, pulling interest-over-time for a keyword list, finding rising related queries and spotting seasonality before you brief content.
- You can **compare keywords** by scoring up to 5 terms on one shared 0-100 scale (similar to adding terms in the Trends UI) to see which topic actually wins.
- **Track trends by country or region** using the interest-by-region breakdown, which is handy for territory planning and localized campaigns.
- **Monitor trending searches** with live **Trending Now** per country, complete with approximate **search volumes**, growth %, category and related queries, useful for newsjacking, content ops and social.
- **Feed AI agents** by asking one for "Google Trends for X" and handing it structured JSON over REST or MCP.
### What you get
**Per keyword** (`type: "keyword"`):
- ✅ **Interest over time**: a dated 0-100 series, plus computed `averageValue`, `peakDate` and `peakValue`.
- ✅ **Interest by region**, with every region scored 0-100 and sorted.
- ✅ **Related queries**, both top and rising, with growth shown like `+140%` or `Breakout`.
- ✅ **Keyword comparison**: up to 5 keywords on a shared scale via `compareTerms`.
- ✅ Full scope control: time range (past hour → since 2004, or custom dates), country/region `geo`, `category`, and property (web / news / images / YouTube / shopping).
**Trending Now** (`type: "trending-now"`, optional):
- ✅ Live trending searches per country with **approximate search volume**, **growth %**, start time, category and related queries, covering a 4-hour to 7-day window.
### Quick start
```json
{
"searchTerms": ["chatgpt", "claude ai"],
"compareTerms": true,
"timeRange": "today 3-m",
"trendingNow": true,
"trendingNowGeos": ["US"]
}
````
Prefer to work from the browser? Paste **`trends.google.com/trends/explore?…` URLs** into `startUrls`, or point `spreadsheetId` at a public Google Sheet of keywords for bulk jobs.
### Migrating from a browser-based Google Trends actor?
Input mapping is one-to-one, and runs are faster and cheaper without Chrome:
| Browser actor | This actor |
|---|---|
| `searchTerms` (comma = compare) | `searchTerms` + `compareTerms: true` |
| `spreadsheetId` (Google Sheet) | `spreadsheetId` (same) |
| `startUrls` (explore URLs) | `startUrls` (same) |
| `timeRange` / `geo` / `category` | `timeRange` (+`customTimeRange`) / `geo` / `category` |
| `viewedFrom` residential proxy | not needed: the actor rotates its own proxy sessions |
| Timeline CSV export | dataset `interestOverTime` (export CSV / Excel / JSON as usual) |
### Output (per keyword)
```json
{
"source": "Google Trends",
"type": "keyword",
"keyword": "chatgpt",
"comparedWith": ["claude ai"],
"geo": "Worldwide",
"timeRange": "today 3-m",
"averageValue": 80.11,
"peakDate": "2026-04-20",
"peakValue": 100,
"interestOverTime": [{ "date": "2026-04-20", "value": 100, "isPartial": false }],
"interestByRegion": [{ "geoCode": "MY", "geoName": "Malaysia", "value": 98 }],
"relatedQueries": {
"top": [{ "query": "chatgpt login", "value": 100 }],
"rising": [{ "query": "chatgpt openai", "formattedValue": "+140%" }]
},
"url": "https://trends.google.com/trends/explore?q=chatgpt",
"scrapedAt": "2026-07-05T21:00:00.000Z"
}
```
Trending Now records carry `query`, `searchVolume` (e.g. `200000`), `volumeGrowthPct`, `startedAt`, `categories` and `relatedQueries`.
### Pricing
Pay per event, no subscription:
| Event | Price | When |
|---|---|---|
| Actor start | **$0.001** | Flat, once per run |
| Keyword result | **$2.00 / 1,000** | Per keyword record (timeline + regions + related queries) |
| Trend found | **$1.00 / 1,000** | Per Trending Now record |
That's **$0.20 for a 100-keyword job**, with no browser compute inflating your platform usage. The tiny start fee only shows up on a run that returns nothing at all.
### FAQ
**Is there an official Google Trends API?** No, Google Trends has no official public API. This actor uses the same JSON endpoints that the Trends website itself loads data from.
**Are the values absolute search counts?** Keyword interest is Google's relative 0-100 index (100 = the peak in your range/region). Trending Now records *do* include approximate absolute volumes (e.g. `200000`).
**How do I compare keywords fairly?** Set `compareTerms: true` so all terms (max 5) share one 0-100 scale, exactly like the Trends UI.
**How do I export Google Trends data to CSV or Excel?** Run the actor, then use Apify's dataset export (CSV / Excel / JSON / RSS), or the API `.../dataset/items?format=csv`.
**Can I scrape hundreds of keywords at once?** Yes, put them in a public Google Sheet and pass `spreadsheetId`, or list them in `searchTerms`.
**What about related topics?** Google currently returns an empty list for the related-*topics* widget to all API clients, so it's off by default (related *queries* work fully). The toggle stays available in case Google re-enables it.
**Does it need a proxy?** You never configure one. Google rate-limits per IP, so the actor rotates Apify datacenter proxy sessions on its own whenever it hits a limit. Bandwidth is negligible (small JSON).
**Can I use it with AI agents?** Yes, with REST API and **MCP**.
***
### Something missing?
If you need an extra field, another source, or a different output, open an issue on this Actor and describe it. I read every request and small additions usually ship within days. More data and lead generation Actors are on [my profile](https://apify.com/tagadanar).
*Keywords: google trends scraper, google trends api, google trends data, interest over time, interest by region, related queries, trending searches, trending now, search volume, keyword research, SEO trends, market research, brand tracking, keyword comparison, google trends export csv, MCP.*
# Actor input Schema
## `searchTerms` (type: `array`):
Keywords to analyse. Each term returns one record with interest over time, interest by region and related queries/topics. Enable Compare terms to score up to 5 terms on a shared 0–100 scale.
## `startUrls` (type: `array`):
Paste trends.google.com/trends/explore?q=… URLs straight from your browser — the terms, location, date range, category and property are read from each URL (comma-separated q = compared terms).
## `spreadsheetId` (type: `string`):
ID of a public Google Sheet ("anyone with the link") whose first column lists search terms — for bulk jobs with hundreds of keywords. The ID is the long token in the sheet URL.
## `compareTerms` (type: `boolean`):
Score all search terms against each other in one comparison (max 5 terms), like adding terms on trends.google.com. Off = each term is scaled to its own peak.
## `timeRange` (type: `string`):
Period for interest-over-time.
## `customTimeRange` (type: `string`):
Overrides the time range above. Format: YYYY-MM-DD YYYY-MM-DD (e.g. 2024-01-01 2024-06-30).
## `geo` (type: `string`):
Country to measure interest in. Need a sub-region (e.g. a US state)? Paste a trends.google.com URL in the URLs field instead — its location is used as-is.
## `category` (type: `string`):
Restrict results to one topic area (like the category picker on trends.google.com).
## `property` (type: `string`):
Which Google property to measure.
## `trendingNow` (type: `boolean`):
Also return what is trending right now (live trending searches with search volume, growth % and related queries) for the countries below.
## `trendingNowGeos` (type: `array`):
Country codes for Trending Now (e.g. US, FR, DE).
## `trendingNowHours` (type: `integer`):
Look-back window: 4, 24, 48 or 168 hours.
## `maxTrends` (type: `integer`):
Cap on Trending Now records per country.
## Actor input object example
```json
{
"searchTerms": [
"bitcoin"
],
"compareTerms": false,
"timeRange": "today 12-m",
"geo": "",
"category": "0",
"property": "",
"trendingNow": false,
"trendingNowGeos": [
"US"
],
"trendingNowHours": 24,
"maxTrends": 25
}
```
# Actor output Schema
## `results` (type: `string`):
One item per keyword (and per trending search when enabled).
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"searchTerms": [
"bitcoin"
],
"maxTrends": 25
};
// Run the Actor and wait for it to finish
const run = await client.actor("tagadanar/google-trends-scraper").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"searchTerms": ["bitcoin"],
"maxTrends": 25,
}
# Run the Actor and wait for it to finish
run = client.actor("tagadanar/google-trends-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"searchTerms": [
"bitcoin"
],
"maxTrends": 25
}' |
apify call tagadanar/google-trends-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=tagadanar/google-trends-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Google Trends Scraper 📈 (results in seconds)",
"description": "Scrape Google Trends as clean JSON: interest over time, interest by region, related queries, keyword comparison and live Trending Now with real search volumes. No browser, no Puppeteer, no API key, just fast results for SEO research, market tracking and AI agents.",
"version": "0.1",
"x-build-id": "Cvtn5xYNVIl4JhQFa"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/tagadanar~google-trends-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-tagadanar-google-trends-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/tagadanar~google-trends-scraper/runs": {
"post": {
"operationId": "runs-sync-tagadanar-google-trends-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/tagadanar~google-trends-scraper/run-sync": {
"post": {
"operationId": "run-sync-tagadanar-google-trends-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"searchTerms": {
"title": "Search terms",
"type": "array",
"description": "Keywords to analyse. Each term returns one record with interest over time, interest by region and related queries/topics. Enable Compare terms to score up to 5 terms on a shared 0–100 scale.",
"items": {
"type": "string"
}
},
"startUrls": {
"title": "Google Trends URLs",
"type": "array",
"description": "Paste trends.google.com/trends/explore?q=… URLs straight from your browser — the terms, location, date range, category and property are read from each URL (comma-separated q = compared terms).",
"items": {
"type": "string"
}
},
"spreadsheetId": {
"title": "Google Sheet ID (bulk terms)",
"type": "string",
"description": "ID of a public Google Sheet (\"anyone with the link\") whose first column lists search terms — for bulk jobs with hundreds of keywords. The ID is the long token in the sheet URL."
},
"compareTerms": {
"title": "Compare terms (shared 0–100 scale)",
"type": "boolean",
"description": "Score all search terms against each other in one comparison (max 5 terms), like adding terms on trends.google.com. Off = each term is scaled to its own peak.",
"default": false
},
"timeRange": {
"title": "Time range",
"enum": [
"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"
],
"type": "string",
"description": "Period for interest-over-time.",
"default": "today 12-m"
},
"customTimeRange": {
"title": "Custom date range",
"type": "string",
"description": "Overrides the time range above. Format: YYYY-MM-DD YYYY-MM-DD (e.g. 2024-01-01 2024-06-30)."
},
"geo": {
"title": "Location",
"enum": [
"",
"US",
"GB",
"CA",
"AU",
"IE",
"NZ",
"IN",
"FR",
"DE",
"ES",
"IT",
"NL",
"BE",
"CH",
"AT",
"PT",
"SE",
"NO",
"DK",
"FI",
"PL",
"CZ",
"RO",
"HU",
"GR",
"TR",
"UA",
"RU",
"MX",
"BR",
"AR",
"CL",
"CO",
"PE",
"JP",
"KR",
"CN",
"TW",
"HK",
"ID",
"TH",
"VN",
"PH",
"MY",
"SG",
"SA",
"AE",
"IL",
"EG",
"ZA",
"NG",
"KE",
"MA"
],
"type": "string",
"description": "Country to measure interest in. Need a sub-region (e.g. a US state)? Paste a trends.google.com URL in the URLs field instead — its location is used as-is.",
"default": ""
},
"category": {
"title": "Category",
"enum": [
"0",
"3",
"47",
"44",
"22",
"12",
"5",
"7",
"71",
"8",
"45",
"65",
"11",
"13",
"958",
"19",
"16",
"299",
"14",
"66",
"29",
"533",
"174",
"18",
"20",
"67"
],
"type": "string",
"description": "Restrict results to one topic area (like the category picker on trends.google.com).",
"default": "0"
},
"property": {
"title": "Search property",
"enum": [
"",
"news",
"images",
"youtube",
"froogle"
],
"type": "string",
"description": "Which Google property to measure.",
"default": ""
},
"trendingNow": {
"title": "Scrape Trending Now",
"type": "boolean",
"description": "Also return what is trending right now (live trending searches with search volume, growth % and related queries) for the countries below.",
"default": false
},
"trendingNowGeos": {
"title": "Trending Now countries",
"type": "array",
"description": "Country codes for Trending Now (e.g. US, FR, DE).",
"default": [
"US"
],
"items": {
"type": "string"
}
},
"trendingNowHours": {
"title": "Trending Now window (hours)",
"minimum": 4,
"maximum": 168,
"type": "integer",
"description": "Look-back window: 4, 24, 48 or 168 hours.",
"default": 24
},
"maxTrends": {
"title": "Max trends per country",
"minimum": 1,
"maximum": 500,
"type": "integer",
"description": "Cap on Trending Now records per country.",
"default": 200
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```