# Google Trends Scraper — Interest, Queries & Trending Now (`jadey_orbit/google-trends-scraper`) Actor

Extract Google Trends data fast: interest over time, interest by region, related queries and topics, and real-time trending searches. Pay per result.

- **URL**: https://apify.com/jadey\_orbit/google-trends-scraper.md
- **Developed by:** [Matt Sparks](https://apify.com/jadey_orbit) (community)
- **Categories:** SEO tools, Marketing
- **Stats:** 1 total users, 1 monthly users, 89.5% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 1,000 data rows

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/platform/actors/running/actors-in-store#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, Related Queries & Trending Now

Extract **Google Trends data** for any keyword: interest over time, interest by region, related queries, related topics, and real-time trending searches. Built API-first (no slow browser automation), so runs finish in **seconds** and cost less.

### What data does it extract?

| Data type | What you get |
|---|---|
| **Interest over time** | 0–100 search-interest index per date for your timeframe |
| **Interest by region** | Interest by country, state/region, city, or US metro area |
| **Related queries** | Top & rising queries with values and growth ("Breakout") |
| **Related topics** | Top & rising topics with type (e.g. Cryptocurrency, Company) |
| **Trending now** | Current trending searches with approximate traffic, start time, and related queries — 300+ entries per region |

Any timeframe Google Trends supports: `now 1-H` … `today 5-y`, `all`, or explicit date ranges. Any country or region. Category filtering supported.

### Why this scraper?

- ⚡ **API-first, not browser-based** — most Google Trends actors drive a headless Chrome through the Trends UI; this one talks to Trends data endpoints directly. Faster runs, lower compute, fewer flaky failures.
- 📊 **All five datasets in one actor** — no need for separate actors for trending searches.
- 💰 **$1.50 per 1,000 rows** — pay only for delivered results.
- 🔁 **Automatic session rotation** — rate limits are handled with retries, backoff, and fresh sessions.

### Pricing

| Event | Price | When charged |
|---|---|---|
| Actor start | $0.02 | Once per run |
| Data row | $0.0015 | Per result row ($1.50 / 1,000) |

**Example**: 12 months of weekly interest + 51 US states + related queries & topics for one keyword ≈ 230 rows ≈ **$0.37**.

### Input

```json
{
    "queries": ["bitcoin", "ethereum"],
    "dataTypes": ["interestOverTime", "interestByRegion", "relatedQueries", "relatedTopics"],
    "timeframe": "today 12-m",
    "geo": "US",
    "regionResolution": "REGION",
    "includeTrendingNow": true,
    "trendingHours": 24
}
```

Leave `queries` empty and enable `includeTrendingNow` to get only trending searches.

### Output examples

```json
{ "type": "interestOverTime", "keyword": "bitcoin", "geo": "US", "date": "2026-04-17T00:00:00.000Z", "value": 86, "isPartial": false }
{ "type": "interestByRegion", "keyword": "bitcoin", "geoCode": "US-WY", "geoName": "Wyoming", "value": 100 }
{ "type": "relatedQueries", "keyword": "bitcoin", "rankType": "RISING", "query": "bitcoin etf", "formattedValue": "+250%" }
{ "type": "trendingNow", "geo": "US", "keyword": "taylor farms", "approxTraffic": 200000, "startedAt": "2026-07-16T21:20:00.000Z", "relatedQueries": ["taylor farms lettuce"] }
```

Download as **JSON, CSV, Excel**, or fetch via API.

### Use from code or AI agents

- **API / SDKs**: run and fetch results with the [Apify API](https://docs.apify.com/api/v2).
- **MCP**: works out of the box with the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp) — Claude, Cursor, and other AI agents can call it as a tool.
- **Scheduling**: run it daily/hourly with Apify Schedules for keyword monitoring.

### Common use cases

- **SEO & content planning** — find rising queries before they peak
- **Market research** — compare brand interest across regions and time
- **Trend monitoring** — feed trending-now data into news/content pipelines
- **Trading signals** — track search interest for tickers and products
- **Ad timing** — schedule campaigns around seasonal interest curves

### Notes & troubleshooting

- Values are Google's relative 0–100 index per query context, not absolute volumes.
- Residential proxy (the default) is strongly recommended; Google rate-limits datacenter IPs.
- A query returning no rows usually means Google has no data for that keyword/region/timeframe combination.
- Issues or feature requests (multi-keyword comparison, categories list, hourly granularity)? Open an issue in the **Issues** tab — answered within 24 hours.

# Actor input Schema

## `queries` (type: `array`):

Keywords to get Google Trends data for (e.g. <code>bitcoin</code>). Each term is processed separately. Not needed in Trending-now mode.

## `dataTypes` (type: `array`):

Which Trends datasets to extract per search term.

## `timeframe` (type: `string`):

Trends time range: <code>now 1-H</code>, <code>now 4-H</code>, <code>now 1-d</code>, <code>now 7-d</code>, <code>today 1-m</code>, <code>today 3-m</code>, <code>today 12-m</code>, <code>today 5-y</code>, <code>all</code>, or explicit dates <code>2025-01-01 2025-06-30</code>.

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

Two-letter country code (e.g. <code>US</code>, <code>GB</code>, <code>DE</code>) or region code (<code>US-NY</code>). Empty = worldwide.

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

Google Trends category ID to narrow results (0 = all categories).

## `regionResolution` (type: `string`):

Granularity for interest-by-region data.

## `includeTrendingNow` (type: `boolean`):

Also extract current trending searches for the selected region (works even with no search terms).

## `trendingHours` (type: `integer`):

How far back to look for trending searches (1–191 hours).

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

Residential proxies are strongly recommended — Google rate-limits datacenter IPs.

## Actor input object example

```json
{
  "queries": [
    "bitcoin"
  ],
  "dataTypes": [
    "interestOverTime"
  ],
  "timeframe": "today 12-m",
  "geo": "",
  "category": 0,
  "regionResolution": "REGION",
  "includeTrendingNow": false,
  "trendingHours": 24,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# 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 = {
    "queries": [
        "bitcoin"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("jadey_orbit/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 = { "queries": ["bitcoin"] }

# Run the Actor and wait for it to finish
run = client.actor("jadey_orbit/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 '{
  "queries": [
    "bitcoin"
  ]
}' |
apify call jadey_orbit/google-trends-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

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