# Google Trends Scraper - Interest, Regions, Related & Trending (`nexuscortex/google-trends-scraper`) Actor

Scrape Google Trends: interest over time, interest by region, metro or city, top and rising related queries, and Trending now searches with volume. Compare any number of keywords on one scale. Web, YouTube, News, Images and Shopping search.

- **URL**: https://apify.com/nexuscortex/google-trends-scraper.md
- **Developed by:** [Nexus Cortex](https://apify.com/nexuscortex) (community)
- **Categories:** SEO tools, Marketing, AI
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.60 / 1,000 keyword reports

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, Regions, Related Queries & Trending Now

Scrape **Google Trends** for any keyword or topic: **interest over time**, **interest by region** (country, state, US metro area or city), and **top and rising related queries**. Also scrape **Trending now**: the searches trending in a country or region in the past 4 hours to 7 days, with search volume, increase and related searches.

**Compare any number of keywords on one scale.** Google Trends compares at most 5 terms per chart. This Actor chains several charts through a common anchor term and rescales them, so 20 brands or 100 product names end up on one comparable 0-100 scale.

Works for **Web, YouTube, News, Image and Google Shopping search**, in 250 countries and their regions, for any period since 2004. No login, no browser, no API key. Use it as a **Google Trends API** for keyword research, SEO and content planning, market and product research, brand tracking, seasonality analysis, or as a data source for dashboards and AI agents.

### What you can scrape

| Data | What you get |
|---|---|
| Interest over time | The 0-100 search interest per minute, hour, day, week or month (Google picks the step from the period), with peak, average and latest value |
| Interest by region | Breakdown by country (Worldwide), region/state, US metro area (DMA) or city with coordinates |
| Related queries | Top related searches, and rising ones with their growth (`+350%`, `Breakout`) |
| Trending now | Trending searches per country or region: volume (`200K+`), increase, start and end time, categories, related searches |
| CSV table | All interest-over-time series in one spreadsheet (one column per keyword) |

### How to scrape Google Trends

1. Click **Try for free** (or **Start**) on this page.
2. Enter **Search terms** and pick **Countries** (and optionally regions like `US-CA`).
3. Choose a **Time range**, **Category** and **Search type** (Web, YouTube, News, Images, Shopping).
4. Turn on **Compare all terms on one scale** to compare keywords with each other.
5. Optionally add **Trending now** countries.
6. Run the Actor and download the results as JSON, CSV, Excel or HTML, or read them through the Apify API.

You can also paste **Google Trends URLs** copied from your browser; the Actor uses their terms, country, dates, category and search type.

### Why use this Google Trends scraper

- **Unlimited keyword comparison on one scale.** Turn on *Compare all terms on one scale* and enter as many terms as you like. Each new chart includes the strongest term found so far, which keeps precision even when one term is hundreds of times bigger than another. In our tests the averages of 8 chained terms matched Google's own 5-term chart within 0.05 points.
- **Built for reliability.** Requests are paced per visitor session and spread over Apify Proxy IPs; a rate-limited session is replaced, not retried in a loop.
- **Every search type and region level.** YouTube, News, Images and Shopping search, plus regional data down to US metro areas and cities.
- **Trending now included.** Up to a few thousand trending searches per country for 7 days, filterable by category and active status, sortable by volume or recency.
- **Clean, flat output.** Dates in ISO format, numbers as numbers, rising queries with a `isBreakout` flag, a summary (average, peak, latest) on every row, and a ready-made CSV of all timelines.
- **Low price.** Pay per keyword report or trending search, nothing per request.

### Input

| Field | Description |
|---|---|
| `searchTerms` | Keywords or topic IDs (`/m/0dl567`), one per line |
| `geos` | Countries (`US`, `GB`, `DE`...) or `WORLDWIDE` (default) |
| `regions` | Regions or US metros: `US-CA`, `GB-SCT`, `US-NY-501` |
| `timeRange` | `now 1-H`, `now 4-H`, `now 1-d`, `now 7-d`, `today 1-m`, `today 3-m`, `today 12-m` (default), `today 5-y`, `all` |
| `customTimeRange` | `YYYY-MM-DD YYYY-MM-DD` (from 2004), or `YYYY-MM-DDTHH YYYY-MM-DDTHH` for hourly data in the past week |
| `category` | Google Trends category ID (`0` = all, `71` = Food & Drink, `7` = Finance...) |
| `property` | `web` (default), `youtube`, `news`, `images`, `shopping` |
| `sharedScale` | Compare all terms of a country on one scale (any number of terms) |
| `exploreUrls` | Google Trends explore URLs; the terms of one URL share a scale |
| `includeInterestByRegion` / `regionResolution` | Regional breakdown (default on) and its level: `auto`, `COUNTRY`, `REGION`, `DMA`, `CITY` |
| `includeRelatedQueries` | Top and rising related queries (default on) |
| `includeRelatedTopics` | Related topics (default off; Google currently returns no data for them on almost every search) |
| `trendingGeos` | Countries or regions for Trending now (`US`, `JP`, `US-CA`) |
| `trendingHours` | `4`, `24` (default), `48` or `168` hours |
| `trendingCategories` / `trendingActiveOnly` / `trendingSort` | Filter by category, skip ended trends, sort by `relevance`, `volume` or `recent` |
| `maxTrendingPerGeo` | Trending searches per country (default 100) |
| `maxItems` | Total cap on results for the run (default 100). This is also your maximum spend |

Example: compare 8 AI assistants in the US over the past 12 months, on one scale:

```json
{
    "searchTerms": ["chatgpt", "gemini", "claude", "copilot", "perplexity", "grok", "deepseek", "mistral ai"],
    "geos": ["US"],
    "sharedScale": true
}
```

Example: YouTube search interest for a product in three countries, by city, plus today's trending searches in Japan:

```json
{
    "searchTerms": ["air fryer"],
    "geos": ["US", "GB", "AU"],
    "property": "youtube",
    "timeRange": "today 5-y",
    "regionResolution": "CITY",
    "trendingGeos": ["JP"],
    "trendingHours": "24"
}
```

### Output

One row per search term and country (`"type": "keyword"`). Example (shortened):

```json
{
    "type": "keyword",
    "searchTerm": "chatgpt",
    "geo": "US",
    "geoName": "United States",
    "timeRange": "today 12-m",
    "resolvedTimeRange": "2025-11-08 2026-11-08",
    "resolution": "WEEK",
    "category": 0,
    "categoryName": "All categories",
    "property": "web",
    "scale": "individual",
    "comparedWith": [],
    "hasData": true,
    "averageInterest": 76.77,
    "peakInterest": 100,
    "peakDate": "2025-11-02T00:00:00.000Z",
    "latestInterest": 79,
    "latestDate": "2026-11-01T00:00:00.000Z",
    "interestOverTime": [
        { "date": "2025-11-02T00:00:00.000Z", "value": 100, "label": "Nov 2 – 8, 2025" },
        { "date": "2025-11-09T00:00:00.000Z", "value": 95, "label": "Nov 9 – 15, 2025" }
    ],
    "regionResolution": "REGION",
    "interestByRegion": [
        { "geoCode": "US-WY", "geoName": "Wyoming", "value": 100 },
        { "geoCode": "US-CA", "geoName": "California", "value": 98 }
    ],
    "relatedQueriesTop": [{ "query": "what is chatgpt", "value": 100 }],
    "relatedQueriesRising": [{ "query": "chatgpt caricature", "value": 3350, "formattedValue": "+3,350%", "isBreakout": false }],
    "exploreUrl": "https://trends.google.com/trends/explore?q=chatgpt&geo=US&date=today%2012-m&hl=en-US",
    "scrapedAt": "2026-11-08T14:46:36.486Z"
}
```

One row per trending search (`"type": "trending"`):

```json
{
    "type": "trending",
    "rank": 1,
    "term": "dana white",
    "geo": "US",
    "geoName": "United States",
    "hours": 24,
    "startedAt": "2026-11-07T18:40:00.000Z",
    "endedAt": null,
    "isActive": true,
    "searchVolume": 500000,
    "searchVolumeLabel": "500K+",
    "increasePercent": 1000,
    "categoryIds": [14, 10],
    "categories": ["Politics", "Law and Government"],
    "trendBreakdown": ["dana white press secretary", "press secretary", "trump dana white"],
    "exploreUrl": "https://trends.google.com/trends/explore?q=dana%20white&geo=US&date=now%201-d&hl=en-US",
    "scrapedAt": "2026-11-08T14:46:30.102Z"
}
```

- Interest values are Google's relative scale: 100 is the peak of the chart, 50 is half as popular, 0 means not enough data. With `sharedScale`, values have up to 2 decimals because charts are rescaled.
- `hasData: false` means Google has not enough data for the search at all (every value is 0). Such rows are saved for free.
- `isPartial: true` marks the latest point when its period is not complete yet; it is left out of `averageInterest` and `latestInterest`.
- `interestByRegion` lists only areas with data, highest first. City rows have `lat`/`lng` instead of `geoCode`.
- `searchVolume` of a trending search is the lower bound of Google's bucket (`500000` = "500K+").

The key-value store also holds `INTEREST_OVER_TIME` (CSV, one row per date and one column per keyword) and `SUMMARY` (requests, failures and per-task counts). A real sample is in `samples/output.json`.

### Pricing

Pay per result:

- **$2.00 per 1,000 keyword reports** (one per search term and country, including interest over time, interest by region and related queries).
- **$0.50 per 1,000 trending searches.**

Nothing is charged per request or per chart, so comparing terms on one scale costs the same as scraping them one by one. Searches where Google has no data at all are saved for free. Set *Maximum results (total)* (or your Apify max-charge limit) to cap spend. Each run also has Apify's standard start fee of $0.00005 ($0.05 per 1,000 runs), which covers the first seconds of compute. Apify subscribers pay less per result: 10% off on Bronze, 15% on Silver and 20% on Gold and higher plans.

### FAQ

**Can I get absolute search volumes?** Google Trends only publishes relative interest (0-100) for keywords. Trending now shows Google's volume buckets (`2K+`, `100K+`, `1M+`), which the Actor saves as `searchVolume`.

**Why do my numbers differ slightly from the website?** Google Trends computes interest from a sample of searches, and the sample changes over time; repeated lookups can differ by a few points, more for rare terms. Use the same run for numbers you want to compare, or turn on the shared scale.

**How does the shared scale work for more than 5 terms?** The first chart has 5 terms. Every next chart has 4 new terms plus the strongest term found so far (the anchor). The anchor's values in both charts give the factor that converts the new chart, and at the end everything is rescaled so the overall peak is 100. A term too small to register next to the others shows 0, as it would on Google.

**Why are related topics empty?** As of November 2026 Google Trends shows "not enough data" for related topics on almost every search, also on the website. The option stays in case Google brings them back.

**Can I get the news articles behind a trending search?** Not from this Actor. Feed the `term` of each trend into our [Google News Scraper](https://apify.com/nexuscortex/google-news-scraper) to get the articles with real publisher URLs.

**I use another Google Trends Actor. Can I keep my input?** Mostly: `searchTerms`, `timeRange`, `customTimeRange` and `category` have the same names, and the Actor also accepts a single `geo` code and `startUrls` (`[{ "url": "https://trends.google.com/trends/explore?..." }]`).

**Can I monitor keywords or trends on a schedule?** Yes. Schedule the Actor in Apify (for example daily with `trendingHours: "24"`) and send the dataset to Google Sheets, Slack, Make, Zapier or n8n.

### Limitations

- Google Trends data is relative and sampled; very rare terms return 0 everywhere.
- Regional and city breakdowns depend on Google having enough data for the area.
- Trending now is not available for Worldwide; use a country or region code.
- The Actor reads the same public data endpoints the Google Trends website uses, without logging in. Google can change them at any time.

### Feedback

Found a bug or need a field? Open an issue in the Issues tab and we will look at it. If this Actor saved you time, a short review on this page helps other users find it.

### More scrapers from NexusCortex

- [Google News Scraper](https://apify.com/nexuscortex/google-news-scraper): news articles by keyword or topic with publisher URLs
- [Google Ads Transparency Scraper](https://apify.com/nexuscortex/google-ads-transparency-scraper): Google Search, YouTube and Display ads of any advertiser
- [Facebook Ads Library Scraper](https://apify.com/nexuscortex/facebook-ads-library-scraper): Facebook and Instagram ads from the Meta Ad Library
- [Threads Search Scraper](https://apify.com/nexuscortex/threads-search-scraper): Threads posts and profiles by keyword, back in time

# Actor input Schema

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

Keywords to look up, one per line. Each term gets one result with interest over time, interest by region and related queries. A Freebase topic ID such as `/m/0dl567` also works.

## `geos` (type: `array`):

Where to measure search interest. Each search term runs once per country. Default: Worldwide.

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

Sub-national areas, added to the countries above: a region like `US-CA`, `GB-SCT`, `DE-BY` or a US metro (DMA) like `US-NY-501`.

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

Period to look at. Google picks the granularity: minutes for the past hours, hours for 7 days, days up to about 9 months, weeks up to 5 years, months beyond.

## `customTimeRange` (type: `string`):

Overrides the time range. Format `YYYY-MM-DD YYYY-MM-DD`, e.g. `2024-01-01 2024-12-31` (from 2004-01-01). For hourly data within the past week: `YYYY-MM-DDTHH YYYY-MM-DDTHH`.

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

Limit the searches to a topic area, e.g. "travel" searches about jaguar the animal vs. the car brand in "Autos & Vehicles". Any of Google's 1,100+ sub-category IDs also works through a Google Trends URL (`cat=`).

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

Which Google search to measure.

## `sharedScale` (type: `boolean`):

Off: each term is scaled on its own (its peak is 100), like typing it alone into Google Trends. On: all terms of a country share one 0-100 scale, so you can see which is searched more. Works for any number of terms: above 5 (Google's limit per chart), the Actor chains several charts through a common anchor term and rescales them.

## `exploreUrls` (type: `array`):

Explore pages copied from the browser, e.g. `https://trends.google.com/trends/explore?q=bitcoin,ethereum&geo=US&date=today%205-y`. The terms of one URL are compared on one scale, and the URL's own country, dates, category and search type are used.

## `includeInterestByRegion` (type: `boolean`):

Add the breakdown by country, region, metro or city.

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

Level of the regional breakdown. Automatic follows Google: countries for Worldwide, regions (states) for a country. Metro areas (DMA) are available for the US.

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

Add the top and rising related searches (rising ones include "Breakout" terms that grew more than 5,000%).

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

Add top and rising related topics. As of November 2026 Google Trends shows "not enough data" for related topics on almost every search, so this usually returns empty lists.

## `trendingGeos` (type: `array`):

Get the "Trending now" searches of these places (one result per trending search): country codes like `US`, `GB`, `JP`, or regions like `US-CA`.

## `trendingHours` (type: `string`):

Searches that started trending within this period.

## `trendingCategories` (type: `array`):

Only trends in these categories. Leave empty for all.

## `trendingActiveOnly` (type: `boolean`):

Skip trends that have already ended.

## `trendingSort` (type: `string`):

Order of the trends.

## `maxTrendingPerGeo` (type: `integer`):

Google lists up to a few thousand trends per country for 7 days, a few hundred for 24 hours.

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

Hard cap on results saved and charged in this run: one per search term and country, plus one per trending search.

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

How many visitor sessions (each with its own proxy IP) work in parallel.

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

Apify Proxy spreads requests across IP addresses so Google's per-IP rate limit is not hit.

## Actor input object example

```json
{
  "searchTerms": [
    "chatgpt",
    "gemini",
    "claude"
  ],
  "geos": [
    "US"
  ],
  "timeRange": "today 12-m",
  "category": "0",
  "property": "web",
  "sharedScale": false,
  "includeInterestByRegion": true,
  "regionResolution": "auto",
  "includeRelatedQueries": true,
  "includeRelatedTopics": false,
  "trendingHours": "24",
  "trendingActiveOnly": false,
  "trendingSort": "relevance",
  "maxTrendingPerGeo": 100,
  "maxItems": 100,
  "maxConcurrency": 4,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

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

One item per search term and country, and one per trending search.

## `interestOverTimeCsv` (type: `string`):

One row per date, one column per search term.

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

Requests, failures and per-task results.

# 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": [
        "chatgpt",
        "gemini",
        "claude"
    ],
    "geos": [
        "US"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("nexuscortex/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 = {
    "searchTerms": [
        "chatgpt",
        "gemini",
        "claude",
    ],
    "geos": ["US"],
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("nexuscortex/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 '{
  "searchTerms": [
    "chatgpt",
    "gemini",
    "claude"
  ],
  "geos": [
    "US"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call nexuscortex/google-trends-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,nexuscortex/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/B9bNz0S7cgWRjP6h3/builds/9oS5jnPeqRnEPHn7U/openapi.json
