# Google Trends Scraper — All Trends Data API (`steadyfetch/google-trends-scraper`) Actor
All working Google Trends data in one reliable scraper: interest over time, multi-keyword compare (up to 5), related queries, interest by region, trending now. Schema-stable JSON, fail-fast errors, no charge for empty or failed results. No start fee. API + MCP ready. CSV/JSON export.
- **URL**: https://apify.com/steadyfetch/google-trends-scraper.md
- **Developed by:** [Steadyfetch Team](https://apify.com/steadyfetch) (community)
- **Categories:** SEO tools, AI, News
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet
## Pricing
from $1.50 / 1,000 trend reports
This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
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
Scrape **[Google Trends](https://trends.google.com)** data as clean, schema-stable JSON — a reliable **Google Trends API** for marketers, SEO tools, and data/AI teams. One actor covers every Trends surface that actually returns data in 2026: interest over time, multi-keyword compare, related queries, interest by region, and trending now. Works with a single keyword or up to 5 in compare mode.
| Surface | What you get | Sample field |
|---|---|---|
| **Interest over time** | Full 0–100 timeline for any keyword, geo, and time range | `data.points[].value` |
| **Multi-keyword compare** | 2–5 keywords scored on one shared scale, like the Trends UI | `comparedWith`, `sharedScale: true` |
| **Related queries** | Top + rising queries with values and % growth | `data.rising[].formattedValue` |
| **Interest by region** | Per-state/country breakdown for the keyword | `data.regions[].geoCode` |
| **Trending now** | Current trending searches per country with traffic estimate + news links | `data.approxTraffic`, `data.news[]` |
### Why this Google Trends scraper?
- **Fail-fast, never hang.** Every request has a hard timeout and a bounded retry budget over rotating residential sessions. A run either returns data or stops with an explicit reason — no infinite loops, no zombie runs, no surprise usage bills.
- **You are never charged for empty results.** Google Trends has a degraded mode where it returns HTTP 200 with an empty payload. This actor detects it, retries on a fresh session, and if a fetch ultimately fails it is reported in the run's `ERRORS` record and **never billed**.
- **Schema-stable JSON.** Every item carries `schemaVersion`, and every field is always present — explicit `null` over silent omission. Your pipeline never breaks on a missing key.
- **Honest scope.** Related *topics* is intentionally not offered: Google's topics feed currently returns empty data platform-wide (verified June 2026 from multiple networks). Actors that still sell it deliver empty rows. We'll ship the surface the day it returns real data.
- **Clean exits, honest partials.** If a run hits your max-cost ceiling or its timeout, it stops cleanly, tells you exactly how many units are left, and how to get the rest.
### How to scrape Google Trends (no code)
1. Click **Try for free** — the form is prefilled with a working example (`bitcoin`, all surfaces).
2. Add your keywords and pick surfaces, location, and time range.
3. Click **Start**. The first results usually land in the dataset within a minute.
4. Export as JSON, CSV, or Excel — or schedule the run to repeat daily/weekly.
### Input example
```json
{
"searchTerms": ["bitcoin", "ethereum"],
"compare": true,
"geo": "US",
"timeRange": "today 12-m",
"includeTrendingNow": true,
"trendingNowGeo": "US"
}
````
### Output examples
**See real output before you run anything** — [live sample dataset](https://api.apify.com/v2/datasets/7zYapT7kpf0Wu6VR0/items?clean=true\&format=json) (actual results, every surface), or a [4-keyword compare run](https://api.apify.com/v2/datasets/ccMy1XLDLbMxlaigu/items?clean=true\&format=json) (chatgpt vs claude vs gemini vs copilot on one shared scale).
One dataset item = one keyword × one surface. Every item shares the same envelope:
```json
{
"schemaVersion": 1,
"surface": "interestOverTime",
"keyword": "bitcoin",
"geo": "US",
"timeRange": "today 12-m",
"category": 0,
"property": "",
"comparedWith": ["ethereum"],
"sharedScale": true,
"fetchedAt": "2026-06-10T16:55:01.000Z",
"data": {
"points": [
{ "date": "2025-06-08T00:00:00.000Z", "timestamp": 1749340800, "formattedTime": "Jun 8 – 14, 2025", "value": 29, "isPartial": false }
]
}
}
```
#### Google Trends related queries API
```json
{
"surface": "relatedQueries",
"keyword": "bitcoin",
"data": {
"top": [ { "query": "bitcoin price", "value": 100, "formattedValue": "100", "link": "https://trends.google.com/trends/explore?q=bitcoin+price" } ],
"rising": [ { "query": "bitcoin etf", "value": 850, "formattedValue": "+850%" } ]
}
}
```
#### Google Trends trending now API
```json
{
"surface": "trendingNow",
"geo": "US",
"data": {
"title": "simone ashley",
"approxTraffic": "200+",
"pubDate": "Tue, 10 Jun 2026 15:00:00 -0700",
"news": [ { "title": "…", "url": "https://…", "source": "…" } ]
}
}
```
Note: Google typically surfaces ~10–20 trending searches per country per pull; some days fewer. Trends values are a relative 0–100 index with sampling variance — small differences vs the Trends UI are normal and documented in the FAQ.
### How much does it cost to scrape Google Trends?
**1 result = one keyword × one surface payload.** A full 12-month timeline is **one** result. A complete related-queries set (top + rising) is **one** result. One trending-now row is one result.
**No start fee, no subscription — you pay only for delivered results.** Failed or empty fetches are never charged.
| What you run | Results | Approx. cost\* |
|---|---|---|
| 1 keyword, all 3 keyword surfaces | 3 | ~$0.01 |
| Track 100 keywords' interest weekly | 430/mo | ~$1.30/mo |
| Track 250 keywords daily | 7,500/mo | ~$22.50/mo |
| Trending now for 3 countries, daily | ~900/mo | ~$2.70/mo |
\*At the FREE-tier event price. Platform usage (compute + residential proxy) is billed separately at cost — typically **$1–3 per 1,000 results**, depending on how many retries your keywords need. Apify's free plan ($5 monthly credit) covers **roughly 1,000 trend reports** — enough to evaluate seriously before paying anything.
### Google Trends API alternative
There is no generally available official Google Trends API: Google's announced API is in **closed alpha** (waitlist, no trending-now surface). The popular Python library **pytrends** is unmaintained, with long-broken endpoints. This actor is a stable HTTP/JSON alternative: callable from any language, schedulable, monitored, exportable to CSV/Sheets — with reliability engineering (residential proxy rotation, consistent browser fingerprints per session, fail-fast retries) that one-off scripts and unmaintained libraries can't sustain.
### Use it via API, MCP, and integrations
```bash
curl "https://api.apify.com/v2/acts/steadyfetch~google-trends-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
-X POST -H 'Content-Type: application/json' \
-d '{"searchTerms":["bitcoin"],"geo":"US","timeRange":"today 3-m"}'
```
```python
from apify_client import ApifyClient
client = ApifyClient("YOUR_TOKEN")
run = client.actor("steadyfetch/google-trends-scraper").call(run_input={
"searchTerms": ["bitcoin", "ethereum"], "compare": True, "geo": "US",
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item["keyword"], item["surface"])
```
**Connect from any MCP client** (Claude, Cursor, …) in one step — add this server to your MCP config:
```json
{
"mcpServers": {
"google-trends": {
"url": "https://mcp.apify.com/?actors=steadyfetch/google-trends-scraper",
"headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
}
}
}
```
**MCP-ready, including multi-keyword compare** (verified end-to-end, June 2026): every input works identically from the UI, the REST API, and MCP clients — the input is one flat JSON schema with no hidden flags. Quick calls (trending now, single keyword) return results inside the tool call; bigger jobs hand back a run you can poll with the bundled dataset tools. Scheduling, monitoring, webhooks, and Make/Zapier connections come with the Apify platform.
### FAQ
#### Is there an official Google Trends API?
Google announced one, but it remains alpha/waitlist-only and does not cover trending now. This actor exists to fill that gap today.
#### Is it legal to scrape Google Trends?
This actor only collects public, non-personal, aggregated data — the same anonymized index anyone sees at trends.google.com. Courts have repeatedly held that scraping publicly accessible data is lawful (e.g., *hiQ v. LinkedIn*, *Meta v. Bright Data*). Still, consult your counsel for your specific use.
#### Why do values differ slightly from the Trends UI?
Trends is a sampled, relative 0–100 index; Google itself returns slightly different values across sessions. Differences of a few points are inherent to the source, not a scraper defect.
#### What happens when Google blocks a request?
The session is discarded and a fresh residential session (new IP, new fingerprint, fresh tokens) retries — up to 5 attempts with cooldowns. If all fail, the fetch is recorded in `ERRORS` with the exact reason, and you are not charged for it.
#### Can I compare 5 keywords?
Yes — set `compare: true` with 2–5 `searchTerms` to get them on one shared scale. Related queries are per-keyword, so fetch them in a second run without `compare`.
#### Where are related topics?
Google's topics feed currently returns empty data platform-wide (verified June 2026). We don't sell empty rows. The surface ships the day Google's data returns.
### Feedback & support
Found an issue or missing a feature? Open it on the **Issues tab** — issues get a response within one business day, and fixes land in the changelog. If this actor saves you time, a review helps other buyers find it.
# Actor input Schema
## `searchTerms` (type: `array`):
Keywords to scrape. Each term is fetched independently unless Compare is on. Pricing: 1 result = one term × one surface (a full timeline, region table, or related-queries set counts as a single result).
## `surfaces` (type: `array`):
Which Trends surfaces to fetch per term. Defaults to all three. Related topics is intentionally not offered: Google's topics feed currently returns empty data platform-wide — we don't sell empty rows.
## `compare` (type: `boolean`):
Scores 2-5 terms on one shared 0-100 scale, exactly like the Trends UI compare view. Related queries are per-term and therefore unavailable in compare mode.
## `geo` (type: `string`):
ISO country/region code, e.g. US, GB, US-CA, DE. Leave empty for worldwide.
## `timeRange` (type: `string`):
A Google preset — 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 — or a custom range like 2025-01-01 2025-06-01.
## `category` (type: `integer`):
Google Trends category ID to narrow results (0 = all categories).
## `property` (type: `string`):
Which Google property to measure interest on.
## `includeTrendingNow` (type: `boolean`):
Also fetch the current trending searches for a country (1 result per trend, with traffic estimate and news links).
## `trendingNowGeo` (type: `string`):
Country code for trending now, e.g. US, GB, SA, JP.
## `proxyCountry` (type: `string`):
Country for the residential proxy exit. Keep US unless you need geo-specific delivery behavior.
## Actor input object example
```json
{
"searchTerms": [
"bitcoin"
],
"surfaces": [
"interestOverTime",
"relatedQueries",
"interestByRegion"
],
"compare": false,
"geo": "",
"timeRange": "today 12-m",
"category": 0,
"property": "",
"includeTrendingNow": false,
"trendingNowGeo": "US",
"proxyCountry": "US"
}
```
# Actor output Schema
## `results` (type: `string`):
One item per keyword × surface (or per trending-now row), schema-stable JSON.
## `errors` (type: `string`):
Present only when fetches failed after all retries: keyword, surface, and reason.
# 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"
]
};
// Run the Actor and wait for it to finish
const run = await client.actor("steadyfetch/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"] }
# Run the Actor and wait for it to finish
run = client.actor("steadyfetch/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"
]
}' |
apify call steadyfetch/google-trends-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=steadyfetch/google-trends-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Google Trends Scraper — All Trends Data API",
"description": "All working Google Trends data in one reliable scraper: interest over time, multi-keyword compare (up to 5), related queries, interest by region, trending now. Schema-stable JSON, fail-fast errors, no charge for empty or failed results. No start fee. API + MCP ready. CSV/JSON export.",
"version": "1.0",
"x-build-id": "1wxRf2iNQn1arONX0"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/steadyfetch~google-trends-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-steadyfetch-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/steadyfetch~google-trends-scraper/runs": {
"post": {
"operationId": "runs-sync-steadyfetch-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/steadyfetch~google-trends-scraper/run-sync": {
"post": {
"operationId": "run-sync-steadyfetch-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 scrape. Each term is fetched independently unless Compare is on. Pricing: 1 result = one term × one surface (a full timeline, region table, or related-queries set counts as a single result).",
"default": [
"bitcoin"
],
"items": {
"type": "string"
}
},
"surfaces": {
"title": "Data surfaces",
"type": "array",
"description": "Which Trends surfaces to fetch per term. Defaults to all three. Related topics is intentionally not offered: Google's topics feed currently returns empty data platform-wide — we don't sell empty rows.",
"items": {
"type": "string",
"enum": [
"interestOverTime",
"relatedQueries",
"interestByRegion"
],
"enumTitles": [
"Interest over time",
"Related queries (top + rising)",
"Interest by region"
]
},
"default": [
"interestOverTime",
"relatedQueries",
"interestByRegion"
]
},
"compare": {
"title": "Compare terms on one scale",
"type": "boolean",
"description": "Scores 2-5 terms on one shared 0-100 scale, exactly like the Trends UI compare view. Related queries are per-term and therefore unavailable in compare mode.",
"default": false
},
"geo": {
"title": "Location",
"type": "string",
"description": "ISO country/region code, e.g. US, GB, US-CA, DE. Leave empty for worldwide.",
"default": ""
},
"timeRange": {
"title": "Time range",
"type": "string",
"description": "A Google preset — 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 — or a custom range like 2025-01-01 2025-06-01.",
"default": "today 12-m"
},
"category": {
"title": "Category ID",
"type": "integer",
"description": "Google Trends category ID to narrow results (0 = all categories).",
"default": 0
},
"property": {
"title": "Search property",
"enum": [
"",
"images",
"news",
"youtube",
"froogle"
],
"type": "string",
"description": "Which Google property to measure interest on.",
"default": ""
},
"includeTrendingNow": {
"title": "Include trending now",
"type": "boolean",
"description": "Also fetch the current trending searches for a country (1 result per trend, with traffic estimate and news links).",
"default": false
},
"trendingNowGeo": {
"title": "Trending now country",
"type": "string",
"description": "Country code for trending now, e.g. US, GB, SA, JP.",
"default": "US"
},
"proxyCountry": {
"title": "Proxy country",
"type": "string",
"description": "Country for the residential proxy exit. Keep US unless you need geo-specific delivery behavior.",
"default": "US"
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```