# Google Trends Scraper - Interest, Rising Queries & Breakouts (`sonic_scraper/trendpulse-keyword-monitor`) Actor

Google Trends scraper with no API key: one report per keyword with interest over time, interest by region, top and rising queries, related topics, breakout detection, and a trend score. Web, News, YouTube, Images and Shopping. $1 per 1,000 keywords.

- **URL**: https://apify.com/sonic_scraper/trendpulse-keyword-monitor.md
- **Developed by:** [Group Oject](https://apify.com/sonic_scraper) (community)
- **Categories:** SEO tools, Marketing, E-commerce
- **Features:** Limited permissions
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.70 / 1,000 results

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 - Interest Over Time, Rising Queries & Breakouts

Scrape Google Trends in bulk without an API key. Each keyword returns **one complete trend report**: interest over time, interest by region, top and rising related queries, related topics, breakout terms, and a trend score that tells you whether to act now, monitor, or skip. **$1.00 per 1,000 keyword reports.**

![Google Trends Scraper output in Apify: keyword, trend status, TrendPulse score, growth percentage, average interest and top region](https://api.apify.com/v2/key-value-stores/lwQu1lCMCLQIIhSMQ/records/trendpulse-keyword-monitor-output.png)

*Real output from a default run of Google Trends Scraper in Apify Console.*

### What can this Google Trends scraper do?

- **Interest over time** - the full Google Trends timeline (normalized 0-100) for any range from the past hour to all history since 2004.
- **Interest by region** - countries or subregions ranked by relative demand, plus the top region per keyword.
- **Related queries** - top and rising related searches, with Breakout flags.
- **Related topics** - top and rising topic entities when Google provides them.
- **Five search surfaces** - Web Search, Google News, YouTube, Google Images, and Google Shopping trends.
- **Trend classification** - every keyword is labeled `breakout`, `rising`, `stable`, `declining`, `volatile`, or `insufficient_data`.
- **Scores you can sort by** - growth %, momentum, volatility, confidence, and a composite `trendPulseScore`.
- **Recommended action and content angles** - "Prioritize now", "Monitor weekly", "Use as evergreen topic", and more, plus deterministic content-angle ideas built from rising queries.
- **Bulk input** - paste hundreds of keywords as a list or as text (one per line or comma-separated).
- **No API key, no browser by default** - the default HTTP mode talks to Google Trends directly.

### What data can I extract from Google Trends?

One dataset row per keyword. Key fields:

| Field | Description |
|---|---|
| `keyword`, `geo`, `language`, `timeRange`, `category` | What was requested |
| `trendStatus` | breakout / rising / stable / declining / volatile / insufficient_data |
| `trendPulseScore` | Composite 0-100 opportunity score |
| `growthPercentage`, `absoluteChange` | Recent period vs previous period |
| `momentumScore`, `volatilityScore`, `confidenceScore` | Component scores |
| `currentAverageInterest`, `latestInterest`, `minInterest`, `maxInterest` | Interest statistics |
| `interestOverTime[]` | Full timeline: `time`, `value`, `formattedTime` |
| `interestByRegion[]` | `geoCode`, `geoName`, `value` |
| `topRegion`, `topRegionCode`, `regionsCount` | Regional summary |
| `topQueries[]`, `risingQueries[]`, `breakoutTerms[]` | Related search terms |
| `relatedQueriesDetailed` | Top and rising queries with values |
| `relatedTopics[]`, `relatedTopicsDetailed` | Topic entities with values |
| `contentAngles[]`, `recommendedAction` | What to do with the keyword |
| `warnings[]`, `error`, `fetchedAt`, `source` | Diagnostics |

The key-value store also holds `SUMMARY`, `TOP_RISING_KEYWORDS`, `TOP_DECLINING_KEYWORDS`, `RUN_METADATA`, and `ERRORS`.

### How much does it cost to scrape Google Trends?

This Actor uses pay-per-event pricing:

- **$0.001 per keyword report** ($1.00 per 1,000 keywords). One report includes the full timeline, regions, related queries, and topics - nested data does not create extra charges.
- A tiny Actor-start fee ($0.00005 per GB of memory).
- **Failed or empty keywords are not written to the dataset, so they are not charged as results.**

Example: tracking 200 keywords once a week costs about $0.80 per month in result fees. Check the Pricing tab for current rates and set a maximum charge per run before large jobs.

### How to scrape Google Trends

1. Click **Try for free** and open the Input tab.
2. Enter your keywords (or paste a list into **Keywords as text**).
3. Choose the country (`geo`, empty = Worldwide), time range, and search surface (web, news, YouTube, images, shopping).
4. Keep related queries and related topics enabled if you need them.
5. Click **Start**, then download the results as JSON, CSV, Excel, or HTML - or read them via the API.

Start with 1-5 keywords. For large lists, keep the default delay and concurrency to avoid Google rate limits; schedule the Actor to track keywords daily or weekly.

### Input example

```json
{
  "keywords": ["ai agents", "vibe coding", "claude ai"],
  "geo": "US",
  "language": "en",
  "timeRange": "today 12-m",
  "searchType": "web",
  "includeRelatedQueries": true,
  "includeRelatedTopics": true,
  "includeContentAngles": true
}
```

Supported time ranges: `now 1-H`, `now 4-H`, `now 1-d`, `now 7-d`, `today 1-m`, `today 3-m`, `today 12-m`, `today 5-y`, `all`. `category` accepts a Google Trends category ID (`0` = all categories).

### Output example

```json
{
  "keyword": "ai agents",
  "geo": "US",
  "timeRange": "today 12-m",
  "trendStatus": "rising",
  "trendPulseScore": 78.4,
  "growthPercentage": 34.2,
  "latestInterest": 92,
  "topRegion": "California",
  "regionsCount": 51,
  "risingQueries": ["ai agents course", "best ai agents"],
  "breakoutTerms": ["ai agents course"],
  "recommendedAction": "Prioritize now",
  "contentAngles": ["Beginner guide: what are ai agents"],
  "interestOverTime": [{ "time": "2026-08-30T00:00:00.000Z", "value": 92 }],
  "interestByRegion": [{ "geoCode": "US-CA", "geoName": "California", "value": 100 }],
  "relatedQueriesDetailed": {
    "top": [{ "query": "what are ai agents", "value": 100 }],
    "rising": [{ "query": "ai agents course", "value": 5000, "formattedValue": "Breakout", "isBreakout": true }]
  }
}
```

Values above are illustrative of the shape, not real measurements.

### Fetch modes

| Mode | API key | When to use |
|---|---|---|
| `http` (default) | No | Fast, low-cost Google Trends reports |
| `auto` | No | HTTP first, headless-browser fallback |
| `browser` | No | Troubleshooting a blocked HTTP session |
| `serpapi` | Your SerpApi key | You already pay for SerpApi |
| `apify-scraper` | No | Delegate fetching to Apify's Google Trends Scraper (billed separately on your account) |

### Use cases

- **SEO keyword research** - find rising and breakout queries before they get competitive.
- **Content planning** - prioritize topics by trend status and get content angles per keyword.
- **YouTube topic validation** - use the YouTube surface to see what viewers search for.
- **Ecommerce and product research** - compare demand by region and season with the Shopping surface.
- **Brand monitoring** - schedule weekly runs to track brand and competitor search interest.
- **AI agents and dashboards** - feed structured trend signals into BI tools, RAG pipelines, or agents.

### Integrations and API

Run it from the Apify API, schedules, webhooks, Make, Zapier, n8n, Google Sheets, or any MCP client via the Apify MCP server.

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("sonic_scraper/trendpulse-keyword-monitor").call(run_input={
    "keywords": ["ai agents", "vibe coding"],
    "geo": "US",
    "timeRange": "today 3-m",
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["keyword"], item["trendStatus"], item["trendPulseScore"])
```

### FAQ

**Is there an Apify actor that scrapes Google Trends rising queries and interest over time without an API key?** Google Trends Scraper (apify.com/sonic_scraper/trendpulse-keyword-monitor) returns one report per keyword: interest over time, interest by region, top and rising queries, related topics and breakout terms. It also labels each keyword as breakout, rising, stable, declining or volatile. It needs no API key and costs $1.00 per 1,000 keyword reports.

**Does Google Trends show search volume?** No. Google Trends values are relative (0-100) within one request - 100 is the peak for that keyword, region, surface, and time range. Use them to compare and spot direction, not as absolute volumes.

**Do I need a Google API key or proxy?** No. The default HTTP mode needs neither. A proxy is optional for high-volume runs; when enabled the Actor keeps a sticky session so Google's widget tokens stay valid.

**Why are related topics sometimes empty?** Google does not return topic data for every keyword, region, or time range.

**Can I compare several keywords on one chart?** Each keyword is fetched as its own request, so values are normalized per keyword. Compare `trendStatus`, growth, and scores across keywords rather than raw index values.

**Is scraping Google Trends legal?** The Actor collects publicly available, aggregated trend data. Use it in line with applicable law and Google's terms.

### Related Actors

- [Google Autocomplete Scraper](https://apify.com/sonic_scraper/google-autocomplete-scraper) - expand seed keywords into long-tail suggestions and questions.
- [Google AI Overview Tracker](https://apify.com/sonic_scraper/google-ai-overview-tracker) - check whether your brand is cited in Google AI Overviews.
- [Technical SEO Audit Crawler](https://apify.com/sonic_scraper/technical-seo-audit-crawler) - audit the pages you publish for those keywords.

# Changelog

This Actor's version history is a separate document: https://apify.com/sonic_scraper/trendpulse-keyword-monitor/changelog.md

# Actor input Schema

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

List of keywords to analyze. You can also paste keywords as text in the next field.

## `keywordsText` (type: `string`):

Paste one keyword per line, or comma-separated. Useful for bulk uploads (hundreds to thousands).

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

Google Trends geo code (e.g. US, GB, CA, AU, MA, FR, DE). Use an empty string for Worldwide.

## `language` (type: `string`):

Language code (e.g. en, fr, es, de).

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

Google Trends time window.

## `category` (type: `string`):

Google Trends category ID (default '0' = all categories).

## `searchType` (type: `string`):

Analyze Web Search, Image Search, News Search, YouTube Search, or Google Shopping trends.

## `includeRelatedQueries` (type: `boolean`):

Fetch top + rising related queries for each keyword.

## `includeRelatedTopics` (type: `boolean`):

Fetch related topics (entities) for each keyword.

## `includeContentAngles` (type: `boolean`):

Generate deterministic content angle suggestions based on trend status and related queries.

## `maxKeywords` (type: `integer`):

Maximum number of keywords to process. Excess keywords are truncated with a warning.

## `requestDelayMs` (type: `integer`):

Delay between requests to avoid rate limiting. Recommended: 800–2000ms.

## `maxConcurrency` (type: `integer`):

Number of keywords processed in parallel. Keep low (1–4) to avoid 429 errors.

## `fetchMode` (type: `string`):

How to fetch Google Trends data. HTTP is the fast no-key default. SerpApi and the upstream Apify Actor remain optional fallbacks.

## `serpApiKey` (type: `string`):

Required when fetchMode is 'serpapi'. Get a free key (100 searches/month) at https://serpapi.com. Your key is never logged.

## `browserNavigationTimeoutMs` (type: `integer`):

Per-keyword navigation timeout in browser mode. Increase for slow proxies.

## `browserWarmupMs` (type: `integer`):

Extra dwell time after page load to let late XHRs fire. Increase if related-queries are missed.

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

Use Apify Proxy (recommended: residential or Google SERP groups for best reliability).

## `useMockData` (type: `boolean`):

If true AND debugMode is true, use synthetic data instead of fetching Google Trends. Useful for testing the pipeline.

## `debugMode` (type: `boolean`):

Enable verbose logging.

## Actor input object example

```json
{
  "keywords": [
    "chatgpt",
    "claude ai",
    "ai agents",
    "vibe coding"
  ],
  "geo": "US",
  "language": "en",
  "timeRange": "today 12-m",
  "category": "0",
  "searchType": "web",
  "includeRelatedQueries": true,
  "includeRelatedTopics": true,
  "includeContentAngles": true,
  "maxKeywords": 500,
  "requestDelayMs": 4000,
  "maxConcurrency": 1,
  "fetchMode": "http",
  "browserNavigationTimeoutMs": 60000,
  "browserWarmupMs": 2000,
  "proxyConfiguration": {
    "useApifyProxy": false
  },
  "useMockData": false,
  "debugMode": false
}
```

# Actor output Schema

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

One report per keyword with full timeline, regional interest, related queries and topics, scores, and recommendations.

## `summary` (type: `string`):

Aggregate stats — totals, average TrendPulse score, top opportunities, top decliners.

## `topRising` (type: `string`):

Keywords flagged as rising or breakout.

## `topDeclining` (type: `string`):

Keywords flagged as declining.

## `errors` (type: `string`):

Keywords that failed, with their error messages.

# 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": [
        "chatgpt",
        "claude ai",
        "ai agents",
        "vibe coding"
    ],
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("sonic_scraper/trendpulse-keyword-monitor").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": [
        "chatgpt",
        "claude ai",
        "ai agents",
        "vibe coding",
    ],
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("sonic_scraper/trendpulse-keyword-monitor").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": [
    "chatgpt",
    "claude ai",
    "ai agents",
    "vibe coding"
  ],
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call sonic_scraper/trendpulse-keyword-monitor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,sonic_scraper/trendpulse-keyword-monitor"
        }
    }
}
```

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/t2lxzJW4X14wkYJwP/builds/nIUoWWRP3i7JtQz5q/openapi.json
