# Google Trends Scraper & Search Intelligence API (`dev00/google-trends-scraper-api`) Actor

Extract real-time Google Trends search interest timeseries (0-100), geographic regional demand, top & breakout rising queries, topics, and live daily trending searches.

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

## Pricing

from $2.00 / 1,000 google trends exploration queries

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 — Real-Time Search Intelligence & Breakouts

[![Apify](https://img.shields.io/badge/Apify-Actor-orange?logo=apify)](https://apify.com/dev00/google-trends-scraper-api)
[![Rating](https://img.shields.io/badge/Rating-★★★★★-yellow)](#)
[![Speed](https://img.shields.io/badge/Speed-~200ms%20Ultra--Fast-brightgreen)](#)
[![Data](https://img.shields.io/badge/Data-Timeseries%20%7C%20Regions%20%7C%20Breakouts%20%7C%20Live%20Trends-blue)](#)

> 🚀 **The #1 Most Complete Google Trends Scraper, Search Intelligence & Breakout Query Extractor on Apify.**\
> Extract normalized 0–100 search volume timeseries, geographic interest down to cities and metros, explosive rising breakout queries (+5000% velocity), Google Knowledge Graph entity topics, real-time daily trending searches with volume estimates (e.g. `200K+ searches`), and instant autocomplete suggestions in sub-250ms.

***

### 🚀 Overview & Key Highlights

**Google Trends Scraper** provides direct, programmatic, high-speed access to Google's worldwide consumer intent database. Built for SEO strategists, e-commerce brands, quantitative hedge funds, product managers, and growth marketers who need real-time consumer search trends without the instability of unofficial libraries or the massive cost of running headless browsers.

Unlike slow browser-based scrapers that crash or get blocked by Google after 5 requests, this Actor reverse-engineers Google's internal endpoints to deliver clean, structured data at lightning speed:

- ⏱️ **Normalized Search Interest Timeseries (0–100)**: Track search interest over hours, days, months, or years with multi-keyword comparison (up to 5 keywords).
- 🗺️ **Geographic Regional Breakdown**: Drill down into geographic search distribution across 250+ countries, states/provinces, DMAs, and metropolitan cities.
- 🔥 **Related Queries & Breakout Detection**: Uncover high-volume Top queries and explosive Rising searches (+5000% breakout velocity).
- 🧠 **Related Topics & Knowledge Graph Entities**: Group search intent by conceptual topics with official Google Knowledge Graph machine IDs (`mid`).
- ⚡ **Real-Time Trending Now**: Direct access to 400+ live breakout searches by country with search volume estimates (e.g. `200K+ searches`), growth rates (+1000%), and linked news articles.
- 🔎 **Instant Typeahead Autocomplete**: Discover search suggestions with entity classifications and deep links.
- 🛍️ **Google Verticals Support**: Query Web Search, Google Shopping (`froogle`), YouTube, Google News, and Google Images.
- 🛡️ **Anti-Bot Immunity**: 100% unique cryptographically randomized User-Agents on every outgoing request with cookie-free execution on real-time feeds.

***

### ⚡ Pre-Configured Saved Tasks (8 Public Ready-to-Run Examples)

You don't need to configure complex inputs! Click and run any of our **8 pre-configured public tasks** directly from the Apify Store:

| # | Task Name | Description | Link |
| :-: | :--- | :--- | :--- |
| 1 | **Google Trends: AI vs ChatGPT (12M Comparison)** | Full 12-month multi-keyword explore comparison between AI and ChatGPT in the US. | [Run Task](https://console.apify.com/actors/iNH3ERvC7vjy83uwv/tasks/3MgOOGU0nt558cGPe) |
| 2 | **Google Trends: Bitcoin vs Solana (90-Day Trend)** | Search interest timeline comparing Bitcoin, Solana, and Ethereum over 90 days. | [Run Task](https://console.apify.com/actors/iNH3ERvC7vjy83uwv/tasks/q14P4E4rz7aMkAuFQ) |
| 3 | **Google Trends: USA Live Trending Searches (24H)** | 50 real-time breakout trending searches across the United States with volume estimates. | [Run Task](https://console.apify.com/actors/iNH3ERvC7vjy83uwv/tasks/3PIuAdrwQ7MBd19sa) |
| 4 | **Google Trends: E-Commerce Shopping (Google Shopping)** | Black Friday & Cyber Monday retail demand trends on the Google Shopping vertical. | [Run Task](https://console.apify.com/actors/iNH3ERvC7vjy83uwv/tasks/UVebdfjxrZWQbhuJm) |
| 5 | **Google Trends: Big Tech Stocks Demand (Finance)** | Search demand trends for Nvidia, Apple, Tesla, and Microsoft in the Finance category. | [Run Task](https://console.apify.com/actors/iNH3ERvC7vjy83uwv/tasks/dm7DFoFlPQNiwjZoa) |
| 6 | **Google Trends: UK Regional Demand (Electric Vehicles)** | Regional demand breakdown across England, Scotland, Wales, and Northern Ireland. | [Run Task](https://console.apify.com/actors/iNH3ERvC7vjy83uwv/tasks/mWQE6IM57PbnkWXEf) |
| 7 | **Google Trends: Breakout Rising Queries (DeepSeek AI)** | High-growth rising queries (+5000% velocity) related to DeepSeek AI. | [Run Task](https://console.apify.com/actors/iNH3ERvC7vjy83uwv/tasks/NhsWxE1ZOTgpPyIPG) |
| 8 | **Google Trends: Autocomplete Entity Discovery** | Instant typeahead search suggestions with Google Knowledge Graph entity IDs. | [Run Task](https://console.apify.com/actors/iNH3ERvC7vjy83uwv/tasks/SlTmiYyhi5dVMn9vG) |

***

### 🌟 Why This Actor Beats Other Scrapers

| Feature | Legacy Python Scrapers | Other Apify Actors | 📈 This Google Trends Actor |
| :--- | :---: | :---: | :---: |
| **Execution Speed** | 🐌 5–10 seconds | 🐌 3–6 seconds | ⚡ **~200ms – 500ms Ultra-Fast** |
| **Compute Units (CU)** | 💸 High CU (Heavy Browser) | 💸 Medium CU | 🟢 **Near-Zero CU (Direct HTTP)** |
| **Pricing Model** | ❌ None / Self-hosted | 💸 $10 – $30 per 1,000 runs | ⚡ **$0.002 Pay-Per-Event (80% cheaper)** |
| **Real-Time Trending Now** | ❌ Broken | ⚠️ Daily Only | ✅ **400+ Live Searches + Volume Estimates** |
| **Breakout Detection (+5000%)** | ⚠️ Unreliable | ⚠️ Partial | ✅ **Exact Growth Score & Breakout Velocity** |
| **Search Volume Estimates** | ❌ Relative Index Only | ❌ Relative Index Only | ✅ **Normalized Index + Exact Search Volumes** |
| **Knowledge Graph Entities** | ❌ No | ❌ No | ✅ **Official Google `mid` Entity IDs** |
| **Anti-Bot Immunity** | ❌ Frequent 429 Bans | ⚠️ IP Blocks | ✅ **100% Unique Dynamic UA per Request** |

***

### 🎯 High-Impact Use Cases

1. **SEO & Viral Content Marketing**:
   Identify breakout queries experiencing explosive +5000% growth before your competitors notice them. Publish timely blog posts, YouTube videos, or TikTok content.
2. **E-Commerce & Amazon/Shopify Product Demand**:
   Filter search demand by Google Shopping (`froogle`) to spot high-demand trending consumer items, forecast seasonal inventory, and adjust PPC bid budgets.
3. **Quantitative Hedge Funds & Trading**:
   Detect brand sentiment inflection points, sudden interest spikes in publicly traded companies, and consumer demand shifts ahead of quarterly earnings calls.
4. **Market Share & Brand Benchmarking**:
   Benchmark multiple brands (e.g. `Nike` vs `Adidas`, `Tesla` vs `BYD`, `OpenAI` vs `Anthropic`) across countries and subregions to calculate organic brand mindshare.
5. **Local Marketing & Geo-Targeted Campaigns**:
   Discover which cities or states have the strongest organic demand for specific services (e.g. "solar panel installation", "weight loss clinic") to target regional ad campaigns.

***

### 🛠️ Input Parameters & Configuration

| Parameter | Type | Default | Description |
| :--- | :--- | :---: | :--- |
| `scrapeMode` | String (select) | `"EXPLORE_ALL"` | Extraction mode: `EXPLORE_ALL`, `INTEREST_OVER_TIME`, `INTEREST_BY_REGION`, `RELATED_QUERIES`, `RELATED_TOPICS`, `TRENDING_NOW`, `AUTOCOMPLETE`. |
| `searchTerms` | Array of Strings | `["artificial intelligence"]` | Keywords or terms to explore and compare (up to 5 keywords). |
| `timeframe` | String (select) | `"today 12-m"` | Time window: `"now 1-H"`, `"now 1-d"`, `"now 7-d"`, `"today 1-m"`, `"today 3-m"`, `"today 12-m"`, `"today 5-y"`, `"all"`. |
| `geo` | String | `"US"` | Country ISO code (e.g. `"US"`, `"GB"`, `"DE"`, or blank for Worldwide). |
| `property` | String (select) | `""` (Web) | Google Search vertical: `""` (Web), `"froogle"` (Shopping), `"youtube"`, `"news"`, `"images"`. |
| `category` | Integer | `0` (All) | Google category taxonomy ID (e.g. `7` for Finance, `18` for Shopping, `67` for Technology). |
| `trendingGeo` | String | `"US"` | Target country code for `TRENDING_NOW` mode. |
| `trendingHours` | Integer | `24` | Time window for live trending searches in hours (`4`, `24`, `48`, `168`). |
| `maxItems` | Integer | `100` | Maximum items to push to the dataset. |

***

### 📝 Sample Input JSON

```json
{
  "scrapeMode": "EXPLORE_ALL",
  "searchTerms": [
    "artificial intelligence",
    "chatgpt"
  ],
  "timeframe": "today 12-m",
  "geo": "US",
  "maxItems": 100
}
```

***

### 📊 Sample Output Dataset Records (JSON)

#### 1. Interest Over Time Record (`timeline_point`)

```json
{
  "recordType": "timeline_point",
  "query": "artificial intelligence",
  "geo": "US",
  "timeframe": "today 12-m",
  "time": 1785628800,
  "formattedTime": "Aug 2, 2026",
  "formattedAxisTime": "Aug 2",
  "value": 78,
  "formattedValue": "78",
  "scrapedAt": "2026-09-02T21:35:00.000Z"
}
```

#### 2. Geographic Regional Record (`regional_point`)

```json
{
  "recordType": "regional_point",
  "query": "artificial intelligence",
  "geo": "US",
  "geoCode": "US-CA",
  "geoName": "California",
  "value": 100,
  "formattedValue": "100",
  "scrapedAt": "2026-09-02T21:35:00.000Z"
}
```

#### 3. Real-Time Trending Search Record (`trending_item`)

```json
{
  "recordType": "trending_item",
  "rank": 1,
  "query": "dancing with the stars 2026 cast",
  "country": "US",
  "countryName": "United States",
  "approximateTraffic": 200000,
  "formattedTraffic": "200K+ searches",
  "growthScore": "+1000%",
  "startedAt": "2026-09-02T10:40:00.000Z",
  "relatedQueries": [
    "dancing with the stars 2026 cast",
    "jenna dewan",
    "dwts cast 2026"
  ],
  "exploreUrl": "https://trends.google.com/trends/explore?q=dancing%20with%20the%20stars%202026%20cast&geo=US",
  "scrapedAt": "2026-09-02T21:35:00.000Z"
}
```

#### 4. Related Query Record (`related_query`)

```json
{
  "recordType": "related_query",
  "parentQuery": "deepseek",
  "queryType": "RISING",
  "query": "deepseek r1",
  "value": 5000,
  "growthScore": "+5,000%",
  "scrapedAt": "2026-09-02T21:35:00.000Z"
}
```

#### 5. Autocomplete Suggestion Record (`autocomplete_item`)

```json
{
  "recordType": "autocomplete_item",
  "query": "apple",
  "title": "Apple",
  "mid": "/m/04st9hr",
  "type": "Technology company",
  "exploreUrl": "https://trends.google.com/trends/explore?q=Apple",
  "scrapedAt": "2026-09-02T21:35:00.000Z"
}
```

***

### 💰 Pay-Per-Event Transparent Pricing

We use Apify's **Pay-Per-Event (PPE)** pricing model. You only pay for successful extractions—no monthly minimums, no idle costs, and zero compute unit billing:

| Charge Event | Price (USD) | Unit Description |
| :--- | :---: | :--- |
| **`trend-query`** | **$0.002** | Complete search interest timeseries, regional demand map, or related search queries per keyword report |
| **`trending-now-batch`** | **$0.003** | 400+ live trending searches by country with search volume estimates & news |
| **`autocomplete-query`** | **$0.0005** | Typeahead suggestion query with Google Knowledge Graph entity IDs |

- **Competitor Cost**: $10.00 – $30.00 per 1,000 reports.
- **Our Cost**: **$2.00 per 1,000 queries** — up to **80% cheaper**, with blazing ~200ms latency.

***

### ❓ Frequently Asked Questions (FAQ)

##### Q: Can I run this Actor via API or Webhook?

Yes! Use the Apify API (`POST https://api.apify.com/v2/acts/dev00~google-trends-scraper-api/runs`) or connect it to Zapier, Make.com, or n8n to trigger automated daily runs.

##### Q: How does this scraper avoid Google blocking?

Our engine routes every request through dynamic randomized modern User-Agents and manages cryptographic Google session tokens in memory. Real-time endpoints (Trending Now and Autocomplete) run completely cookie-free for maximum resilience.

##### Q: What formats can I export the data in?

Apify automatically supports exporting the dataset in **JSON, CSV, Excel (XLSX), XML, and HTML table** formats.

##### Q: Can I compare multiple keywords?

Yes! In the `searchTerms` array, provide up to 5 keywords (e.g. `["nvidia", "apple", "tesla"]`) to generate synchronized comparative interest timelines.

# Actor input Schema

## `scrapeMode` (type: `string`):

Select which type of Google Trends data to extract.

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

List of keywords to analyze or compare (e.g. \['bitcoin', 'ethereum']).

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

Historical or real-time window for search interest analysis.

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

Two-letter country ISO code (e.g. 'US', 'GB', 'CA', 'AU', 'DE', 'FR', 'IN', 'JP'). Leave empty for Worldwide.

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

Google Trends Category ID (0 for all categories, 7 for Finance, 18 for Shopping, 34 for Technology).

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

Search vertical to analyze.

## `trendingGeo` (type: `string`):

Country code for extracting live trending searches (e.g. 'US', 'GB', 'IN', 'CA', 'AU', 'DE', 'FR', 'JP', 'BR', 'MX').

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

Time window for live trending searches in hours (e.g. 4, 24, 48, 168).

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

Maximum number of records to write to the dataset.

## Actor input object example

```json
{
  "scrapeMode": "EXPLORE_ALL",
  "searchTerms": [
    "artificial intelligence"
  ],
  "timeframe": "today 12-m",
  "geo": "US",
  "category": 0,
  "property": "",
  "trendingGeo": "US",
  "trendingHours": 24,
  "maxItems": 100
}
```

# Actor output Schema

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

No description

## `keyValueStoreResult` (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 = {
    "searchTerms": [
        "artificial intelligence"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("dev00/google-trends-scraper-api").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": ["artificial intelligence"] }

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

```

## MCP server setup

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

```

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/iNH3ERvC7vjy83uwv/builds/tgmH2FAd0y0nibvlf/openapi.json