# Google Trends Scraper & API: Rising Queries & Trending Now (`crunchy_galaxy_qcr/google-trends-scraper`) Actor

Google Trends scraper and API alternative for any keyword: interest over time, a rising or falling verdict, interest by region, related and breakout queries, plus today's trending searches (trending now). Keywords with no data are never charged.

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

## Pricing

from $3.00 / 1,000 keyword results

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?

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 and trending now

Get Google Trends data for any list of keywords, with a plain verdict on each one: **rising, falling or stable**. Each keyword comes back with its interest over time, the regions where it is strongest, related and **breakout** queries, and a link to the same view on Google Trends. You can also pull **today's trending searches** for any country.

There is no public Google Trends API to sign up for. This Actor reads the same public data the Trends website shows. No Google account, login or API key is needed.

**Try it:** the form is filled with `standing desk` and `nike, adidas` for the US. That is 3 keyword results, **about $0.009**.

![Real Google Trends Scraper output](https://api.apify.com/v2/key-value-stores/GMEuhx7aSQ9VxqkXd/records/google-trends-scraper-output.png?signature=1pvcFHo4yvJmrub7CBhIl)

*Real results from a run on November 11, 2026.*

**Keywords with no data are never charged.** If Google has nothing for a keyword, you still get a row saying so, and it costs nothing.

#### What you get for each keyword

- **Trend verdict**: `rising`, `falling` or `stable`, from comparing the last quarter of the period with the first, plus the percent change. Keywords with too few data points are marked `insufficient-data` instead of being given a made-up direction.
- **Interest over time**: every point on the 0-100 scale, with partial (still filling) points flagged.
- **Latest, average and peak** interest, and the date of the peak.
- **Interest by region**: countries, states or regions ranked 0-100.
- **Related queries**: top and rising, with Google's growth label (`+350%`) and an `isBreakout` flag for queries growing more than 5,000%.
- **Related topics**, when Google provides them for the keyword.
- **A link** that opens the same keyword, region and period on Google Trends.

#### Compare keywords on one scale

Google Trends scores are relative. A keyword on its own line is scored against itself. To compare keywords against each other, put up to five on one line separated by commas:

```
nike, adidas, puma
```

Each keyword still gets its own row, and `comparedWith` lists the others that share its scale.

#### Trending now

Add country codes under **Trending now: countries** to get today's trending searches: the search, its rank, Google's approximate search count, when it started trending, and the news articles behind it. This works on its own, with no search terms.

#### Input

| Field | What it does |
|---|---|
| Search terms | One keyword per line, or up to five on a line separated by commas to compare them |
| Country or region | `US`, `GB`, `DE`, or a region such as `US-CA`. Empty means worldwide |
| Time range | Past hour through 2004 to present, or a custom start and end date |
| Search type | Web, Image, News, YouTube or Google Shopping search |
| Category ID | Google Trends category number; 0 is all categories |
| Interest by region | On by default |
| Related queries | On by default |
| Related topics | Off by default |
| Trending now: countries | Country codes for today's trending searches |
| Proxy | Optional. Off by default |

Example input:

```json
{
    "searchTerms": ["ai agents", "nike, adidas"],
    "geo": "US",
    "timeRange": "today 12-m",
    "trendingNowCountries": ["US"]
}
```

#### Output

One row per keyword. This is a real row from a run on November 11, 2026, with the lists shortened:

```json
{
    "type": "keyword",
    "keyword": "ai agents",
    "geo": "US",
    "timeRange": "today 12-m",
    "hasData": true,
    "direction": "stable",
    "changePercent": -12.3,
    "latestValue": 25,
    "averageValue": 43.1,
    "peakValue": 100,
    "peakDate": "2026-06-07T00:00:00.000Z",
    "timeline": [
        { "date": "2025-11-09T00:00:00.000Z", "label": "Nov 9 – 15, 2025", "value": 25, "isPartial": false }
    ],
    "regions": [
        { "code": "US-CA", "name": "California", "value": 22 }
    ],
    "relatedQueries": {
        "top": [{ "query": "best ai agents", "value": 100 }],
        "rising": [{ "query": "openclaw", "growth": "Breakout", "isBreakout": true }]
    },
    "exploreUrl": "https://trends.google.com/trends/explore?q=ai%20agents&geo=US&date=today%2012-m"
}
```

Trending-now rows look like this:

```json
{
    "type": "trending",
    "geo": "US",
    "rank": 2,
    "query": "cavaliers vs knicks",
    "approxTraffic": "20000+",
    "startedAt": "2026-11-11T23:10:00.000Z",
    "news": [{ "title": "How to watch Cavaliers vs Knicks", "source": "Yahoo Sports", "url": "https://sports.yahoo.com/..." }]
}
```

The dataset has two ready-made table views, **Keywords** and **Trending now**, and exports to JSON, CSV or Excel.

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

You pay per result, with no monthly fee:

| Event | Price |
|---|---|
| Keyword result (timeline, verdict, regions and related queries included) | $0.003 |
| Trending-now search | $0.001 |
| Keyword with no data | Free |

Worked examples on the Free plan:

- 100 keywords: **$0.30**
- 1,000 keywords: **$3.00**
- Today's trending searches for 5 countries (about 10 each): **$0.05**

Regions and related queries are part of the keyword result. They are not charged separately.

#### Run it every week

Trends data matters most when you watch it move. Save your keyword list as a task and schedule it weekly. Each run's `direction` and `changePercent` tell you which keywords turned, and the rising queries show what people started searching for since last time.

#### Use it from AI agents (MCP)

The Actor works as a tool for AI assistants through Apify's MCP server:

```
https://mcp.apify.com?tools=crunchy_galaxy_qcr/google-trends-scraper
```

The only field an agent has to set is `searchTerms`. Every output field has a description, and a keyword with no data returns `hasData: false` instead of an error, so an agent can tell "nothing found" apart from "something broke".

#### Code example

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_API_TOKEN>' });
const run = await client.actor('crunchy_galaxy_qcr/google-trends-scraper').call({
    searchTerms: ['standing desk', 'nike, adidas'],
    geo: 'US',
    timeRange: 'today 12-m',
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
for (const row of items) console.log(row.keyword, row.direction, row.changePercent);
```

#### FAQ

##### Is there an official Google Trends API?

Google announced an alpha Trends API in 2025, open by application only. There is no public API you can switch on today. This Actor reads the public Trends website instead.

##### What do the 0-100 numbers mean?

They are relative, not search counts. 100 is the point of highest interest for that keyword, region and period, and every other value is scaled against it. Use this Actor to compare periods, regions and keywords, not to estimate search volume.

##### Why does a keyword say `insufficient-data`?

Google had data on only a handful of points in the period. Calling that rising or falling would be a guess, so the Actor does not. Try a longer time range or a wider region.

##### Why are the numbers slightly different from what I saw on the website?

Google Trends works from a sample of searches, so the same query can return slightly different values on different days. The most recent point is also partial until its period ends, which is why it is flagged `isPartial` and left out of the verdict.

##### Do I need a proxy?

Usually not. The Actor runs without one by default and retries with a pause if Google asks it to slow down. For runs of several hundred keywords, turning on a proxy in the input makes rate limits less likely.

##### Is it legal to scrape Google Trends?

Google Trends is public, aggregated data with no personal information. As with any automated collection, you are responsible for how you use the results and for following the terms that apply to you. If you are unsure, ask a lawyer.

#### Related tools

- [Google Ads Transparency Center Scraper](https://apify.com/crunchy_galaxy_qcr/google-ads-transparency-scraper): your competitors' Google Search, YouTube and Display ads, with new and stopped ad alerts.
- [Microsoft Ads Library Scraper](https://apify.com/crunchy_galaxy_qcr/microsoft-ads-library-scraper): the same competitors' Bing ads in the EU.
- [AI Visibility Tracker](https://apify.com/crunchy_galaxy_qcr/ai-visibility-tracker): whether ChatGPT, Gemini and Perplexity recommend your brand.
- [AI Citation Tracker](https://apify.com/crunchy_galaxy_qcr/ai-citation-tracker): which websites AI answers cite in your market.

Found a problem or want a field added? Open an Issue on this Actor's page.

# Actor input Schema

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

One keyword per line. Each keyword gets its own 0-100 interest scale. To compare keywords on one shared scale, put up to five on one line separated by commas, for example: nike, adidas, puma

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

Two-letter country code such as US, GB or DE, or a region code such as US-CA. Leave empty for worldwide.

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

How far back to look. Ignored when you set both a start date and an end date.

## `startDate` (type: `string`):

Optional. Use with the end date for a custom range (YYYY-MM-DD).

## `endDate` (type: `string`):

Optional. Use with the start date for a custom range (YYYY-MM-DD).

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

Which Google property to measure.

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

Google Trends category number. 0 means all categories.

## `includeRegions` (type: `boolean`):

Add the ranked list of countries, states or regions for each keyword.

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

Add related searches, including rising and breakout queries.

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

Add related topics.

## `trendingNowCountries` (type: `array`):

Optional. Two-letter country codes to pull today's trending searches for, each with its approximate traffic and news links. Works on its own, with no search terms.

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

Language for region and topic names, for example en-US, de or fr.

## `timezoneOffsetMinutes` (type: `integer`):

Minutes behind UTC, as Google Trends counts it. 0 is UTC, 300 is US Eastern, -60 is Central Europe.

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

Optional. Runs without a proxy by default. Turn one on if Google rate-limits a large run.

## Actor input object example

```json
{
  "searchTerms": [
    "standing desk",
    "nike, adidas"
  ],
  "geo": "US",
  "timeRange": "today 12-m",
  "property": "web",
  "category": 0,
  "includeRegions": true,
  "includeRelatedQueries": true,
  "includeRelatedTopics": false,
  "language": "en-US",
  "timezoneOffsetMinutes": 0
}
```

# Actor output Schema

## `keywords` (type: `string`):

One row per keyword: trend verdict (rising, falling, stable), percent change, latest, average and peak interest, with a link to the same view on Google Trends.

## `trending` (type: `string`):

Today's trending searches for the requested countries: rank, search, approximate traffic and start time.

## `allResults` (type: `string`):

Every row with all fields, including the full timeline, regions, related queries and news links.

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

Counts for this run: keyword results, keywords without data (not charged), trending searches and failures.

# 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": [
        "standing desk",
        "nike, adidas"
    ],
    "geo": "US"
};

// Run the Actor and wait for it to finish
const run = await client.actor("crunchy_galaxy_qcr/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": [
        "standing desk",
        "nike, adidas",
    ],
    "geo": "US",
}

# Run the Actor and wait for it to finish
run = client.actor("crunchy_galaxy_qcr/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": [
    "standing desk",
    "nike, adidas"
  ],
  "geo": "US"
}' |
apify call crunchy_galaxy_qcr/google-trends-scraper --silent --output-dataset

```

## MCP server setup

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