# Google Trends Scraper (`piotrv1001/google-trends-scraper`) Actor

The Google Trends Scraper extracts search-interest data for any keyword — interest over time (hourly to 5 years), interest by region, top and rising related queries — plus the live Trending Now feed with traffic estimates for any country. Ideal for SEO, market research and content planning.

- **URL**: https://apify.com/piotrv1001/google-trends-scraper.md
- **Developed by:** [FalconScrape](https://apify.com/piotrv1001) (community)
- **Categories:** SEO tools, Developer tools, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $10.00 / 1,000 keyword reports

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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 — Interest Over Time, Regions, Related Queries & Trending Now

Extract Google Trends data for any keyword without an API key. The **Google Trends Scraper** returns search interest over time, interest by region, and top and rising related queries for each keyword — plus the live **Trending Now** feed with approximate search volume, growth, related queries and news coverage for any country — as clean JSON, CSV or Excel.

### ✨ Features

- 📈 **Interest over time**: 0–100 search interest for any keyword — hourly for the past day or week, daily for 1–3 months, weekly for a year or more, back to 2004.
- 🗺️ **Interest by region**: every US state, or every country worldwide, ranked by relative interest.
- 🔍 **Related queries**: the top 25 and the 25 fastest-rising related searches, including *Breakout* terms.
- 🔥 **Trending Now**: hundreds of currently trending searches per country with approximate traffic, growth, start time, related queries and news-article counts.
- 🌍 **Any region, any surface**: country or sub-region codes (`US`, `GB`, `US-CA`…) and Web, Image, News, YouTube or Shopping search.
- 🗂️ **Category filter**: narrow interest to Finance, Sports, Health, Shopping and 20 other Google Trends categories.
- ⚡ **Fast and reliable**: no browser — a keyword takes a few seconds and runs never time out.

### 🛠️ How It Works

1. **Enter keywords** – one per line. Pick a region, a time range and (optionally) a search type or category.
2. **Optionally turn on Trending Now** – to also get what people are searching for right now in that region.
3. **Run the scraper** – results land in the dataset, ready to download or fetch via API.

### 💵 Pricing

Pay only for what you extract:

| Event                                                           | Price             |
| --------------------------------------------------------------- | ----------------- |
| Keyword report (interest over time + regions + related queries) | $0.01 per keyword |
| Trending Now entry                                              | $0.001 per trend  |

A 100-keyword research run costs about $1. The full US Trending Now feed (~450 entries) costs about $0.45.

### 📊 Sample Output Data

Keyword report:

```json
{
    "keyword": "bitcoin",
    "geo": "US",
    "timeRange": "today 12-m",
    "category": 0,
    "property": "web",
    "averageInterest": 35.9,
    "peakInterestDate": "Feb 1 – 7, 2026",
    "interestOverTime": [
        { "date": "2025-08-24T00:00:00.000Z", "label": "Aug 24 – 30, 2025", "value": 29, "isPartial": false },
        { "date": "2025-08-31T00:00:00.000Z", "label": "Aug 31 – Sep 6, 2025", "value": 27, "isPartial": false }
    ],
    "interestByRegion": [
        { "geoCode": "US-WY", "geoName": "Wyoming", "value": 100 },
        { "geoCode": "US-NV", "geoName": "Nevada", "value": 42 }
    ],
    "relatedQueriesTop": [
        {
            "query": "bitcoin price",
            "value": 100,
            "formattedValue": "100",
            "url": "https://trends.google.com/trends/explore?q=bitcoin+price&date=today+12-m&geo=US"
        }
    ],
    "relatedQueriesRising": [
        {
            "query": "how to buy bitcoin safely",
            "value": 14450,
            "formattedValue": "Breakout",
            "url": "https://trends.google.com/trends/explore?q=how+to+buy+bitcoin+safely&date=today+12-m&geo=US"
        }
    ],
    "url": "https://trends.google.com/trends/explore?q=bitcoin&date=today+12-m&geo=US",
    "scrapedAt": "2026-08-26T18:15:05.385Z"
}
```

Trending Now entry:

```json
{
    "keyword": "tim curry",
    "geo": "US",
    "startedAt": "2026-08-26T15:10:00.000Z",
    "approxTraffic": 1000000,
    "trafficGrowthPercent": 1000,
    "relatedQueries": ["tim curry movies", "rocky horror picture show", "tim curry home alone"],
    "categoryIds": [4],
    "newsArticleCount": 31,
    "url": "https://trends.google.com/trending?geo=US&q=tim%20curry",
    "scrapedAt": "2026-08-26T18:15:07.979Z"
}
```

Interest values are relative (0–100) to the peak for the chosen keyword, region and time range, exactly as on Google Trends. Related topics are not included — Google only shows them to signed-in users.

### 🗂️ Category IDs

`0` = all categories (default). Top-level categories:

| ID  | Category                | ID  | Category           | ID  | Category       |
| --- | ----------------------- | --- | ------------------ | --- | -------------- |
| 3   | Arts & Entertainment    | 45  | Health             | 66  | Pets & Animals |
| 47  | Autos & Vehicles        | 65  | Hobbies & Leisure  | 29  | Real Estate    |
| 44  | Beauty & Fitness        | 11  | Home & Garden      | 533 | Reference      |
| 22  | Books & Literature      | 13  | Internet & Telecom | 174 | Science        |
| 12  | Business & Industrial   | 958 | Jobs & Education   | 18  | Shopping       |
| 5   | Computers & Electronics | 19  | Law & Government   | 20  | Sports         |
| 7   | Finance                 | 16  | News               | 67  | Travel         |
| 71  | Food & Drink            | 299 | Online Communities |     |                |
| 8   | Games                   | 14  | People & Society   |     |                |

Sub-categories (e.g. `25` Advertising & Marketing, `356` Aerospace & Defense) work too — the ID is the `cat=` parameter in any Google Trends URL.

Track what the world is searching for with the **Google Trends Scraper** today! 🚀

# Actor input Schema

## `keywords` (type: `array`):

Search terms to analyze, one per line. Each keyword returns interest over time, interest by region and related queries.

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

Two-letter country code (US, GB, DE, IN…) or a region code such as US-CA. Leave empty for worldwide.

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

Period for interest over time. Shorter ranges give finer resolution (hourly for 1–7 days, daily for 1–3 months, weekly for a year or more).

## `property` (type: `string`):

Which Google surface to measure interest on.

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

Google Trends category to narrow results, e.g. 7 = Finance, 12 = Business & Industrial, 71 = Food & Drink, 20 = Sports. 0 = all categories. The full list is in the README.

## `trendingNow` (type: `boolean`):

Also scrape the currently trending searches for the region — each with an approximate search volume, growth, related queries and news coverage count.

## `trendingHours` (type: `string`):

How far back the Trending Now feed looks.

## `maxItems` (type: `integer`):

Stop after this many results (keywords + trends).

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

Proxies keep requests reliable. The default works well.

## Actor input object example

```json
{
  "keywords": [
    "bitcoin",
    "ethereum"
  ],
  "geo": "US",
  "timeRange": "today 12-m",
  "property": "",
  "category": 0,
  "trendingNow": false,
  "trendingHours": "24",
  "maxItems": 50,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# 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 = {
    "keywords": [
        "bitcoin",
        "ethereum"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

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

# Prepare the Actor input
run_input = {
    "keywords": [
        "bitcoin",
        "ethereum",
    ],
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("piotrv1001/google-trends-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "keywords": [
    "bitcoin",
    "ethereum"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call piotrv1001/google-trends-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,piotrv1001/google-trends-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/BfIk4otNanFQP4D7o/builds/XaqLKbodSwd9tnhrG/openapi.json