# 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:** 10 total users, 3 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 extracted trends

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# 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.*

# Changelog

This Actor's version history is a separate document: https://apify.com/sian.agency/google-trends-scraper/changelog.md

# 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(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 '{
  "geo": "US",
  "maxResults": 1000
}' |
apify call sian.agency/google-trends-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,sian.agency/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/8Sx2dKHHkCbjiPMbR/builds/prExYJOJXZXJ2hc3j/openapi.json