# Google Trends Explorer (`originalvi/google-trends-explorer`) Actor

Interest over time, interest by region, related queries & topics for any search term. Fast API-based scraping, no browser.

- **URL**: https://apify.com/originalvi/google-trends-explorer.md
- **Developed by:** [Andrew Schneidwind](https://apify.com/originalvi) (community)
- **Categories:** Automation, SEO tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 search term analyzeds

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

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 Explorer — trends data as clean JSON, no browser

Get clean, structured Google Trends data for any search term in seconds — **interest over time, interest by region, related queries, and related topics** — without a browser, without rate-limit headaches, and without wrestling CSV exports.

### What you get

For every search term, one dataset item containing:

- **Interest over time** — the familiar 0–100 Trends curve, one point per interval, with `isPartial` flags on incomplete periods, plus computed `averageInterest` and `peak` (date + value).
- **Interest by region** — every country/region with data, ranked 0–100.
- **Related queries** — *top* and *rising* (including `Breakout` markers) with Trends' own scoring.
- **Related topics** — *top* and *rising* topic entities with their type (e.g. *Company*, *Search term*).

Each term is fetched separately, so every term gets its own full 0–100 scale (no cross-term normalization surprises).

### How to get Google Trends data

1. Enter one or more **search terms**.
2. Pick a **time range** (past hour up to 2004–present; default past 12 months) and optionally a **country/region** and **category**.
3. Toggle which sections you need (interest over time / by region / related queries / related topics).
4. Click **Start** and export as JSON, CSV, or Excel — or pull via API.

No Google account, no CSV downloads, no browser automation.

### Input

| Field | Description |
|---|---|
| `searchTerms` | One or more terms to analyze |
| `timeRange` | Past hour → 2004-present (default: past 12 months) |
| `geo` | Country (`US`), region (`US-NY`), or empty for worldwide |
| `category` | Google Trends category ID (0 = all) |
| `includeInterestOverTime` / `ByRegion` / `RelatedQueries` / `RelatedTopics` | Toggle each dataset section |
| `proxyConfiguration` | Apify Proxy settings |

### Example output

```json
{
  "searchTerm": "chatgpt",
  "timeRange": "today 12-m",
  "geo": "worldwide",
  "averageInterest": 62.4,
  "peak": { "date": "Mar 2026", "value": 100 },
  "interestOverTime": [
    { "date": "Jul 6 – Jul 12, 2025", "timestamp": 1751760000, "value": 48, "isPartial": false }
  ],
  "interestByRegion": [
    { "geoCode": "PH", "geoName": "Philippines", "value": 100 }
  ],
  "relatedQueries": {
    "top": [{ "query": "chatgpt login", "value": 100, "formattedValue": "100" }],
    "rising": [{ "query": "chatgpt 5", "value": 45500, "formattedValue": "Breakout" }]
  },
  "relatedTopics": {
    "top": [{ "title": "ChatGPT", "type": "Chatbot", "value": 100, "formattedValue": "100" }],
    "rising": []
  },
  "status": "SUCCEEDED"
}
````

### Pricing

You pay a small fee **per successfully analyzed term** — $5.00 per 1,000 terms plus a few cents of platform usage. Failed terms are never charged. No subscriptions, no minimums.

### Use cases

- **SEO & content planning** — find rising queries before they get competitive; `Breakout` markers are early-warning signals.
- **Market research** — compare demand across countries and seasons before entering a market.
- **Trading & e-commerce signals** — track interest spikes for products, tickers, and brands.
- **Trend dashboards** — schedule the Actor and pipe fresh Trends data anywhere via the Apify API.
- **AI agents** — let your agent check whether a topic is rising or fading before acting on it.

### Run it from your own code

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("originalvi/google-trends-explorer").call(run_input={
    "searchTerms": ["standing desk", "walking pad"],
    "timeRange": "today 12-m",
    "geo": "US",
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["searchTerm"], "avg:", item["averageInterest"], "peak:", item["peak"])
```

Works the same with the JavaScript `apify-client`, raw HTTP API, or no-code tools (Make, Zapier, n8n).

### FAQ

**Is there an official Google Trends API?**
No — Google has never shipped a public Trends API. This Actor reads the same internal endpoints the Trends website uses and returns the data as clean JSON.

**Why do my terms each have their own 0–100 scale?**
Google normalizes to the highest point *within a request*. This Actor fetches each term separately so no term gets flattened by a more popular one. If you need Google's comparative scaling, run terms together in one Trends UI session — for data pipelines, per-term scales are usually what you want.

**What does `Breakout` mean in related queries?**
Google's label for a rising query that grew more than 5000%. These are the earliest trend signals available anywhere.

**I'm getting `RATE_LIMITED` errors — what do I do?**
Google throttles datacenter IPs aggressively. Switch the proxy configuration to **residential** proxies and the errors disappear. Failed terms are never charged.

**Can I get hourly data?**
Yes — use `now 7-d` or shorter time ranges for hourly granularity. Longer ranges (e.g. `today 12-m`) return weekly points, same as the Trends UI.

### Tips

- Category IDs: see the [community-maintained list](https://github.com/pat310/google-trends-api/wiki/Google-Trends-Categories).
- Schedule a weekly run on your niche's seed terms and diff the `rising` queries — that's a free trend-spotting machine.

### More Actors by this developer

- [Google News Scraper](https://apify.com/originalvi/google-news-scraper) — see what's being written about the trends you find
- [Hacker News Scraper](https://apify.com/originalvi/hacker-news-scraper) — what developers are saying about it
- [eBay Sold Listings Scraper](https://apify.com/originalvi/ebay-sold-listings) — real sold prices + price statistics
- [App Store Reviews Scraper](https://apify.com/originalvi/app-store-reviews-scraper) — iOS reviews & ratings across 20+ countries
- [Website Screenshot Pro](https://apify.com/originalvi/website-screenshot-pro) — pixel-perfect full-page screenshots

### Found a problem?

Open an issue on the **Issues** tab and I'll fix it fast — usually within a day.

# Actor input Schema

## `searchTerms` (type: `array`):

Terms to analyze. Each term is fetched separately so every one gets its own 0–100 interest scale.

## `timeRange` (type: `string`):

Period to cover.

## `geo` (type: `string`):

Two-letter country code (e.g. `US`, `GB`, `DE`), a region code like `US-NY`, or leave empty for worldwide.

## `category` (type: `integer`):

Google Trends category ID to narrow results (0 = all categories). Find IDs at https://github.com/pat310/google-trends-api/wiki/Google-Trends-Categories

## `includeInterestOverTime` (type: `boolean`):

Include the interest-over-time series (the main Trends chart).

## `includeInterestByRegion` (type: `boolean`):

Include the geographic breakdown of interest.

## `includeRelatedQueries` (type: `boolean`):

Include top and rising related search queries.

## `includeRelatedTopics` (type: `boolean`):

Include top and rising related topics.

## `proxyConfiguration` (type: `object`):

Proxies to use. Google rate-limits datacenter IPs aggressively — residential proxies are recommended if you see RATE\_LIMITED errors.

## Actor input object example

```json
{
  "searchTerms": [
    "chatgpt"
  ],
  "timeRange": "today 12-m",
  "geo": "",
  "category": 0,
  "includeInterestOverTime": true,
  "includeInterestByRegion": true,
  "includeRelatedQueries": true,
  "includeRelatedTopics": true,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchTerms": [
        "chatgpt"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("originalvi/google-trends-explorer").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchTerms": ["chatgpt"],
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("originalvi/google-trends-explorer").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": [
    "chatgpt"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call originalvi/google-trends-explorer --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=originalvi/google-trends-explorer",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Google Trends Explorer",
        "description": "Interest over time, interest by region, related queries & topics for any search term. Fast API-based scraping, no browser.",
        "version": "1.0",
        "x-build-id": "U1J5ar0cgAZkfzz7F"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/originalvi~google-trends-explorer/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-originalvi-google-trends-explorer",
                "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/originalvi~google-trends-explorer/runs": {
            "post": {
                "operationId": "runs-sync-originalvi-google-trends-explorer",
                "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/originalvi~google-trends-explorer/run-sync": {
            "post": {
                "operationId": "run-sync-originalvi-google-trends-explorer",
                "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",
                "required": [
                    "searchTerms"
                ],
                "properties": {
                    "searchTerms": {
                        "title": "Search terms",
                        "type": "array",
                        "description": "Terms to analyze. Each term is fetched separately so every one gets its own 0–100 interest scale.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "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 to cover.",
                        "default": "today 12-m"
                    },
                    "geo": {
                        "title": "Region (geo code)",
                        "type": "string",
                        "description": "Two-letter country code (e.g. `US`, `GB`, `DE`), a region code like `US-NY`, or leave empty for worldwide.",
                        "default": ""
                    },
                    "category": {
                        "title": "Category ID",
                        "type": "integer",
                        "description": "Google Trends category ID to narrow results (0 = all categories). Find IDs at https://github.com/pat310/google-trends-api/wiki/Google-Trends-Categories",
                        "default": 0
                    },
                    "includeInterestOverTime": {
                        "title": "Interest over time",
                        "type": "boolean",
                        "description": "Include the interest-over-time series (the main Trends chart).",
                        "default": true
                    },
                    "includeInterestByRegion": {
                        "title": "Interest by region",
                        "type": "boolean",
                        "description": "Include the geographic breakdown of interest.",
                        "default": true
                    },
                    "includeRelatedQueries": {
                        "title": "Related queries",
                        "type": "boolean",
                        "description": "Include top and rising related search queries.",
                        "default": true
                    },
                    "includeRelatedTopics": {
                        "title": "Related topics",
                        "type": "boolean",
                        "description": "Include top and rising related topics.",
                        "default": true
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Proxies to use. Google rate-limits datacenter IPs aggressively — residential proxies are recommended if you see RATE_LIMITED errors."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```