# Google Trends Scraper — Trending Searches by Country (`sian.agency/google-trends-scraper`) Actor

Scrape Google Trends trending searches into clean JSON/CSV. Get every trending term for any country with its search-traffic volume, the news articles driving it, and a thumbnail. Scrape many countries in one run. No code, no API key.

- **URL**: https://apify.com/sian.agency/google-trends-scraper.md
- **Developed by:** [SIÁN OÜ](https://apify.com/sian.agency) (community)
- **Categories:** SEO tools, Business, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 trend extracteds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
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

## Google Trends Scraper — Trending Searches by Country, Traffic & News 📊

[![SIÁN Agency Store](https://img.shields.io/badge/Store-SI%C3%81N%20Agency-1AE392)](https://apify.com/sian.agency?fpr=sian) [![Google News Scraper](https://img.shields.io/badge/Store-Google%20News%20Scraper-4285F4)](https://apify.com/sian.agency/google-news-scraper?fpr=sian) [![Google SERP Scraper](https://img.shields.io/badge/Store-Google%20SERP%20Scraper-34A853)](https://apify.com/sian.agency/google-serp-scraper?fpr=sian) [![Google Shopping Scraper](https://img.shields.io/badge/Store-Google%20Shopping%20Scraper-FBBC05)](https://apify.com/sian.agency/google-shopping-price-scraper?fpr=sian)

#### 🎉 Capture what the world is searching **right now** — every trending term by country, with its search-traffic volume and the news stories driving it.
##### Built for trend-spotters, news & social teams, marketers, and market researchers who need real-time demand signals in clean JSON/CSV.

---

### 📋 Overview

**Know what's breaking before it peaks.** This scraper pulls the current trending searches for any country — the exact terms people are searching for surge in right now — and returns each one with its approximate search volume, the news articles fueling it, and a thumbnail. Scrape one country or dozens in a single run.

**Why teams choose this scraper:**
- 🌎 **Any country, many at once**: Get trending searches for the US, UK, Germany, Japan, Brazil, India and 100+ regions — batch several in one run.
- ⚡ **Real-time signal**: The freshest trending terms, updated continuously — spot breakouts as they happen.
- 📰 **Context included**: Each trend ships with the news articles driving it (headline, source, link, image) — not just a bare keyword.
- 📈 **Traffic volume**: Every term carries an approximate search-volume band (e.g. `500K+`, `2000+`) so you can rank by momentum.
- 💸 **Pay only for results**: Transparent pay-per-result pricing — you're never charged until your input is validated.
- 🧹 **Clean, ready-to-use data**: Structured JSON/CSV/Excel out of the box — no parsing, no setup, no API key.

---

### ✨ Features

- 🔥 **Trending searches by country** — the live list of surging search terms for any region.
- 📊 **Search-traffic bands** — an approximate volume for every term so you can sort by heat.
- 📰 **News context** — the articles driving each trend: title, source, URL, snippet, thumbnail.
- 🌍 **Multi-region runs** — pass a list of countries and get them all in one dataset.
- 🖼️ **Thumbnails** — a representative image URL for each trend, ready for dashboards.
- 🕒 **Trend timing** — when each term started trending.
- 📦 **Export anywhere** — JSON, CSV, Excel, or pull straight from the dataset API.
- 🚫 **No account, no API key** — just enter a country and run.

---

### 🎬 Quick Start

Pick a country (or paste a list of them), set how many records you want, and run. The scraper fetches the live trending feed and returns one clean record per trending term.

```bash
curl -X POST "https://api.apify.com/v2/acts/sian.agency~google-trends-scraper/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"geo": "US"}'
````

***

### 🚀 Getting Started (3 Simple Steps)

#### Step 1: Choose your region

Enter a country code in **Region** — e.g. `US`, `GB`, `DE`, `JP`, `BR`, `IN`. Leave it blank for worldwide.

#### Step 2: (Optional) Add more countries

Use **Multiple regions** to paste a list of country codes and scrape them all in one run.

#### Step 3: Run and export

Click **Start**. When it finishes, download your results as JSON, CSV, or Excel — or read them from the dataset API.

***

### 📊 Output Data

Each record is one trending search term:

| Field | Description |
|---|---|
| `id` / `keyword` | The trending search term |
| `geo` | The region it's trending in (e.g. `US`) |
| `traffic` | Approximate search-volume band (e.g. `500K+`) |
| `published_at` | When the term started trending |
| `articles` | News articles driving the trend (title, source, URL, snippet, image) |
| `related_queries` | Related sub-queries for the term (when available) |
| `url` | Google Trends explore link for the term |
| `source` | Always `google_trends` |

#### Example record

```json
{
  "id": "world cup fixtures",
  "keyword": "world cup fixtures",
  "geo": "US",
  "mode": "list",
  "traffic": "500K+",
  "published_at": "Tue, 23 Jun 2026 10:20:00 -0700",
  "related_queries": [],
  "articles": [
    {
      "title": "World Cup 2026: full schedule and how to watch",
      "url": "https://example-news.com/world-cup-fixtures",
      "source": "Example News",
      "time_ago": null,
      "snippet": null,
      "image_url": "https://encrypted-tbn0.gstatic.com/images?q=..."
    }
  ],
  "url": "https://trends.google.com/trends/explore?geo=US&hl=en-US&q=world+cup+fixtures",
  "source": "google_trends"
}
```

***

### 💡 Use Cases

- **Real-time trend spotting** — catch breakout topics the moment they surge.
- **News & social monitoring** — see what's driving public attention by country, with sources.
- **Content & ad timing** — publish and bid when interest is peaking.
- **Market research** — track demand shifts across regions over time.
- **SEO & keyword seeding** — discover fresh, high-momentum search terms to target.
- **Newsroom & PR** — find the stories the public is actively searching for.

***

### ❓ FAQ

**Which countries are supported?**
100+ — pass any ISO country code (e.g. `US`, `GB`, `DE`, `JP`, `BR`, `IN`) or a country-subregion like `US-CA`. Leave the region blank for worldwide.

**How fresh is the data?**
It reflects the current trending-searches feed, which updates continuously throughout the day.

**Do I need an account or API key?**
No. Just enter a region and run.

**What formats can I export?**
JSON, CSV, and Excel, or pull directly from the Apify dataset API.

**Is there a free tier?**
Yes — the FREE tier returns up to 25 records per run so you can evaluate the output before scaling.

***

### ⭐ Support

Love this tool? A [5-star review](https://apify.com/sian.agency/google-trends-scraper/reviews) helps other users discover it and helps us build more features.

Explore more automation tools by [SIÁN Agency →](https://apify.com/sian.agency?fpr=sian)

***

*Disclaimer: This is an independent tool and is not affiliated with, endorsed by, or sponsored by Google LLC. "Google" and "Google Trends" are trademarks of Google LLC. This scraper accesses only publicly available information and is intended for lawful use in compliance with applicable terms and regulations.*

# Actor input Schema

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

Country (or country-subregion) to get trending searches for. Examples: `US`, `GB`, `DE`, `JP`, `BR`, `IN`, `US-CA`. Leave blank for **worldwide**.

💡 To scrape several countries in one run, use the **Multiple regions** field below.

## `regions` (type: `array`):

Scrape the trending searches for **many countries** in a single run (one set of records per region).

📋 Click **Bulk edit** to paste one region code per line (e.g. `US`, `GB`, `DE`, `JP`), or use **+ Add**.

🎯 **TIER LIMITS:** FREE up to 25 records/run · PAID unlimited.

## `maxResults` (type: `integer`):

Upper bound on records saved this run. FREE tier is always capped at 25; PAID is unlimited (this value still applies as your own ceiling).

## Actor input object example

```json
{
  "geo": "US",
  "maxResults": 1000
}
```

# 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 = {
    "geo": "US",
    "maxResults": 1000
};

// Run the Actor and wait for it to finish
const run = await client.actor("sian.agency/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 = {
    "geo": "US",
    "maxResults": 1000,
}

# Run the Actor and wait for it to finish
run = client.actor("sian.agency/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 '{
  "geo": "US",
  "maxResults": 1000
}' |
apify call sian.agency/google-trends-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Google Trends Scraper — Trending Searches by Country",
        "description": "Scrape Google Trends trending searches into clean JSON/CSV. Get every trending term for any country with its search-traffic volume, the news articles driving it, and a thumbnail. Scrape many countries in one run. No code, no API key.",
        "version": "1.0",
        "x-build-id": "LfILRsZHmsYZKPGhZ"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/sian.agency~google-trends-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-sian.agency-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/sian.agency~google-trends-scraper/runs": {
            "post": {
                "operationId": "runs-sync-sian.agency-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/sian.agency~google-trends-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-sian.agency-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": {
                    "geo": {
                        "title": "🌎 Region",
                        "type": "string",
                        "description": "Country (or country-subregion) to get trending searches for. Examples: `US`, `GB`, `DE`, `JP`, `BR`, `IN`, `US-CA`. Leave blank for **worldwide**.\n\n💡 To scrape several countries in one run, use the **Multiple regions** field below.",
                        "default": "US"
                    },
                    "regions": {
                        "title": "🌍 Multiple Regions (optional)",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Scrape the trending searches for **many countries** in a single run (one set of records per region).\n\n📋 Click **Bulk edit** to paste one region code per line (e.g. `US`, `GB`, `DE`, `JP`), or use **+ Add**.\n\n🎯 **TIER LIMITS:** FREE up to 25 records/run · PAID unlimited.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxResults": {
                        "title": "🔢 Max Records",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Upper bound on records saved this run. FREE tier is always capped at 25; PAID is unlimited (this value still applies as your own ceiling).",
                        "default": 1000
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```