# Google Trends Scraper ($1.90/1K) (`carabain-digital/google-trends`) Actor

Google Trends data by search term or URL: interest over time, by country, region, city and metro, related queries, plus Trending now per country. Same output as Apify's Google Trends Scraper, with a residential IP per term so runs don't hit 429.

- **URL**: https://apify.com/carabain-digital/google-trends.md
- **Developed by:** [Carabain Digital](https://apify.com/carabain-digital) (community)
- **Categories:** SEO tools, Marketing
- **Features:** Limited permissions, Single-tenant, Server interface
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.14 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
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

#### What is Google Trends Scraper?

**Google Trends Scraper** gets **Google Trends data for any search term or Trends URL**: **interest over time, interest by country, region, city and US metro area, and top and rising related queries**, for any country, time range, category and Google property (Web, YouTube, News, Images, Shopping). It also collects **Trending now**: what people search for right now per country, with search volume and increase. The output has **the same fields as Apify's Google Trends Scraper**, so you can switch without changing your code. Every search term gets its own residential IP, so runs don't stall on Google's "429 Too Many Requests". Built for **SEO and content research, market and demand analysis, ad planning and dashboards**. Prefilled example: two keywords, ready in seconds. Costs **$1.90 per 1,000 results**.

- 🔁 **Drop-in replacement** for apify/google-trends-scraper: same input names, same output keys
- 🛡️ **No 429s**: a fresh residential IP per search term, built in and included in the price
- 📈 **Interest over time** with ISO dates, by **country, region, city and metro**
- 🔎 **Related queries**: top and rising (with "Breakout")
- ⚖️ **Compare up to 5 terms** in one result, like on trends.google.com
- 🔥 **Trending now** per country: up to 200 trends with volume, increase %, related searches and category
- 🔌 **Connect anywhere**: API, schedules, webhooks, Google Sheets, Make, Zapier, MCP / AI agents

#### What data can I get?

<table>
<tr><td>📈 Interest over time (0-100 per term)</td><td>🗺️ Interest by country, region, city, metro (DMA)</td></tr>
<tr><td>🔎 Top and rising related queries</td><td>⚖️ Comparisons of up to 5 terms</td></tr>
<tr><td>🔥 Trending now: search, volume, increase %, active</td><td>🏷️ Related searches and categories per trend</td></tr>
</table>

#### How do I scrape Google Trends?

1. [Create a free Apify account](https://console.apify.com/sign-up) and open this Actor.
2. Enter **search terms** (or paste **Google Trends URLs**), and pick a **geo area**, **time range** and **category**.
3. Optionally add countries under **Trending now**.
4. Click **Start**, then download the results from the **Output** tab as JSON, CSV, Excel, XML or HTML.

#### How much does it cost?

You pay per result: **$1.90 per 1,000 results**, no subscription and no start fee. One result is one search term (or one comparison) with all its data, or one Trending now trend. 100 keywords cost $0.19. The residential proxy is included. The monthly credit of Apify's Free plan ($5) covers about 2,600 results. Paid plans get volume discounts.

#### ⬇️ Input

| Field | Description |
|---|---|
| **Search terms** (`searchTerms`) | One term per line |
| **Multiple terms** (`isMultiple`) | Compare comma-separated terms (up to 5) |
| **Time range** (`timeRange`) / **Custom time range** (`customTimeRange`) | Past hour to 2004-present, or `YYYY-MM-DD YYYY-MM-DD` |
| **Geo area** (`geo`) | Country code, empty = worldwide |
| **Category** (`category`) / **Google property** (`property`) | Narrow to a category or to YouTube, News, Images, Shopping |
| **Google Trends URLs** (`startUrls`) | Explore URLs; terms and filters are read from the URL |
| **Google Sheet ID** (`spreadsheetId`) | Public sheet with terms in column A |
| **Trending now** (`trendingCountries`, `trendingHours`) | Countries and period (4 h, 24 h, 48 h, 7 days) |
| **Max items** (`maxItems`) | Cap the number of results |

```json
{
    "searchTerms": ["web scraping", "bitcoin, ethereum"],
    "isMultiple": true,
    "geo": "US",
    "timeRange": "today 5-y",
    "trendingCountries": ["US", "NL"]
}
```

#### ⬆️ Output

One result per search term or comparison. Fields that do not apply are empty lists.

```json
{
    "inputUrlOrTerm": "bitcoin",
    "searchTerm": "bitcoin",
    "geo": "US",
    "timeRange": "today 12-m",
    "category": "0",
    "property": "web",
    "interestOverTime_timelineData": [
        {"time": "1794096000", "date": "2026-11-08", "formattedTime": "Nov 8 – 14, 2026", "formattedAxisTime": "Nov 8, 2026",
         "value": [17], "hasData": [true], "formattedValue": ["17"], "isPartial": true}
    ],
    "interestOverTime_averages": [],
    "interestBySubregion": [{"geoCode": "US-WY", "geoName": "Wyoming", "value": [100], "formattedValue": ["100"], "maxValueIndex": 0, "hasData": [true]}],
    "interestByCity": [{"coordinates": {"lat": 37.3541079, "lng": -121.9552356}, "geoName": "Santa Clara", "value": [100], "formattedValue": ["100"], "maxValueIndex": 0, "hasData": [true]}],
    "interestByMetro": [{"geoCode": "759", "geoName": "Cheyenne WY-Scottsbluff NE", "value": [100], "formattedValue": ["100"], "maxValueIndex": 0, "hasData": [true]}],
    "relatedQueries_top": [{"query": "bitcoin price", "value": 100, "formattedValue": "100", "hasData": true, "link": "/trends/explore?q=bitcoin+price&date=today+12-m&geo=US"}],
    "relatedQueries_rising": [],
    "relatedTopics_top": [],
    "relatedTopics_rising": [],
    "scrapedAt": "2026-11-08T12:00:00Z"
}
```

A Trending now item:

```json
{
    "type": "trending",
    "query": "heerenveen - feyenoord",
    "geo": "NL",
    "searchVolume": 50000,
    "increasePercentage": 1000,
    "active": true,
    "startedAt": "2026-11-08T10:20:00Z",
    "endedAt": null,
    "trendBreakdown": ["heerenveen - feyenoord", "feyenoord", "sc heerenveen"],
    "categories": ["Sports"],
    "url": "https://trends.google.com/trends/explore?q=heerenveen%20-%20feyenoord&geo=NL&date=now%207-d",
    "scrapedAt": "2026-11-08T12:00:00Z"
}
```

#### What can I do with Google Trends data?

- 🔍 **Keyword research**: top and rising related queries, including Breakout, before you write
- 🗓️ **Seasonality analysis**: interest over time back to 2004 to plan launches and stock
- ⚖️ **Brand and competitor comparison**: up to 5 terms in one result, by country
- 🗺️ **Regional demand and local SEO**: interest by country, region, city and US metro area
- 📰 **Trending now monitor**: up to 200 trends per country with volume and increase %, hourly for newsrooms
- 🧠 **AI agents and forecasting**: feed demand signals into forecasts and dashboards

#### ⚠️ Good to know

- **Values are relative** (0-100 within the request), as on trends.google.com; compare terms in one request to compare them with each other.
- **Related topics**: Google currently withholds them from automated access, so `relatedTopics_top`/`_rising` are usually empty. The fields stay for compatibility.
- **Small countries or rare terms** can return little or no regional data; that is what Google shows too.
- **Trending now** volumes are Google's lower bounds ("50K+" = 50000).

#### Frequently asked questions

#### Can I switch from apify/google-trends-scraper?

Yes. Use the same input (`searchTerms`, `isMultiple`, `timeRange`, `geo`, `category`, `customTimeRange`, `startUrls`, `spreadsheetId`, `maxItems`) and read the same keys (`interestOverTime_timelineData`, `interestBySubregion`, `relatedQueries_top`, ...). Timeline points get an extra `date` field in ISO format.

#### Can I use it with the Apify API?

Yes. Python:

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("carabain-digital/google-trends").call(run_input={"searchTerms": ["padel", "pickleball"], "geo": "NL"})
for r in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(r["searchTerm"], [p["value"][0] for p in r["interestOverTime_timelineData"]][-4:])
```

JavaScript:

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

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('carabain-digital/google-trends').call({ trendingCountries: ['US'] });
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.map((t) => `${t.query} (${t.searchVolume}+)`));
```

#### Can I call it as a real-time API?

Yes. This Actor also runs as a **Server Actor**: send an HTTP request and get the results back in the response, no run to start or dataset to fetch. Handy for search interest for a term inside your own app or dashboard. Pass the same fields as the normal input, in the query string (repeat a key for a list) or as a JSON body:

```bash
curl "https://carabain-digital--google-trends.apify.actor/?searchTerms=web%20scraping&geo=US&timeRange=today%203-m" \
  -H "Authorization: Bearer <YOUR_APIFY_TOKEN>"
```

The response is a JSON array of the same items a normal run returns, billed the same way. Errors come back as `{"error": ..., "message": ...}` with status 400 (invalid input) or 502 (the site blocked the request). The first request after a pause takes a few seconds longer while the server starts. See the **Server** tab for details.

#### Can I use it through an MCP server or with AI agents?

Yes. Add it to an AI agent through the [Apify MCP server](https://mcp.apify.com) (`https://mcp.apify.com?tools=carabain-digital/google-trends`). Example prompt: *"Use Google Trends Scraper to compare interest in padel and pickleball in the Netherlands over the past 5 years."*

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

Google Trends shows public, aggregated and anonymous search interest; there is no personal data in it. Check Google's terms for your use case. More background: [Is web scraping legal?](https://blog.apify.com/is-web-scraping-legal/)

#### Not working? Feedback

Open an issue on the **Issues** tab with the run link and we will look at it. Ideas are welcome there too.

#### Other scrapers by us

| Actor | Covers |
|---|---|
| [EU Dividends & Splits by ISIN](https://apify.com/carabain-digital/eu-dividends) | Dividend history and calendar of European shares |
| [Tripadvisor Reviews](https://apify.com/carabain-digital/tripadvisor-reviews) | Hotel, restaurant and attraction reviews |

⭐ **Does it work well for you?** A review on the Store page helps others find this Actor and helps us keep it maintained.

# Actor input Schema

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

Search terms to look up, one per line. Each term gives one result. Turn on **Multiple terms** to compare up to 5 comma-separated terms in one result, like on trends.google.com.

## `isMultiple` (type: `boolean`):

If checked, a comma separates terms that are compared with each other (`bitcoin, ethereum`), up to 5 per line.

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

Predefined time range (default: past 12 months).

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

Overrides Time range. Format `YYYY-MM-DD YYYY-MM-DD`, e.g. `2024-01-01 2024-06-30`.

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

Country to get results for (default: worldwide). Worldwide gives interest by country; a country gives interest by subregion and city, the US also by metro area (DMA).

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

Limit the search to a category (default: all categories).

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

Which Google search to measure (default: web search).

## `startUrls` (type: `array`):

Paste explore URLs from trends.google.com, e.g. `https://trends.google.com/trends/explore?q=bitcoin,ethereum&geo=US`. Terms, geo, date, category and property are read from the URL.

## `spreadsheetId` (type: `string`):

(Optional) ID of a public Google Sheet with search terms in the first column; row 1 is the header.

## `trendingCountries` (type: `array`):

Also get the Trending now list (what people search for right now) for these countries, two-letter codes such as `US`, `NL`, `DE`. Up to about 200 trends per country with search volume, increase %, related searches and categories.

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

Time window for Trending now.

## `viewedFrom` (type: `string`):

Country of the exit IP. Google Trends numbers do not depend on it; leave empty unless you need a specific country.

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

Language of category and topic names, e.g. `en-US`, `nl`, `de`.

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

Maximum number of results. Zero means no limit.

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

Keep the default: the Actor then uses its own residential proxy with a new IP per search term (included in the price). Google blocks datacenter IPs after a few dozen requests.

## Actor input object example

```json
{
  "searchTerms": [
    "web scraping",
    "artificial intelligence"
  ],
  "isMultiple": false,
  "timeRange": "",
  "geo": "",
  "category": "",
  "property": "",
  "trendingHours": "24",
  "language": "en-US",
  "maxItems": 0,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

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

One result per search term or comparison.

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

Trending now items, if requested.

# 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": [
        "web scraping",
        "artificial intelligence"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("carabain-digital/google-trends").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": [
        "web scraping",
        "artificial intelligence",
    ],
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("carabain-digital/google-trends").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": [
    "web scraping",
    "artificial intelligence"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call carabain-digital/google-trends --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,carabain-digital/google-trends"
        }
    }
}
```

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/DSYm8XqOWoqKXKzus/builds/YADaG8EyjYFWRHxc2/openapi.json
