Google Trends Scraper

Scrape Google Trends data including interest over time, related queries, related topics, and regional interest. Built for the Apify platform.

Features

• 🔍 Multiple search terms - Compare up to 5 keywords at once
• 🌍 Geographic filtering - Filter by country/region
• 📅 Flexible time ranges - From past hour to past 5 years
• 📊 Comprehensive data extraction:
  • Interest over time (time series)
  • Related queries (top & rising)
  • Related topics (top & rising)
  • Interest by region/subregion
• 🔄 Automatic retries - Handles rate limiting gracefully
• 🛡️ Proxy support - Residential proxies for reliability

Input

Field	Type	Description	Default
searchTerms	array	Keywords to search (required)	-
geo	string	Country code (e.g., "US", "GB")	"" (worldwide)
timeRange	string	Time period for data	"today 12-m"
category	number	Google Trends category ID	0 (all)
proxyConfiguration	object	Apify proxy settings	Residential
maxConcurrency	number	Parallel requests (1-5)	1

Time Range Options

• now 1-H - Past hour
• now 4-H - Past 4 hours
• now 1-d - Past day
• now 7-d - Past 7 days
• today 1-m - Past 30 days
• today 3-m - Past 90 days
• today 12-m - Past 12 months
• today 5-y - Past 5 years

Output

Each search term produces one dataset item:

{
    "searchTerm": "artificial intelligence",
    "geo": "US",
    "timeRange": "today 12-m",
    "scrapedAt": "2026-01-18T05:25:00.000Z",
    "interestOverTime": [
        { "date": "Jan 19, 2025", "value": 75 },
        { "date": "Jan 26, 2025", "value": 82 }
    ],
    "relatedQueries": {
        "top": [{ "query": "chatgpt", "value": 100 }],
        "rising": [{ "query": "claude ai", "value": "+5000%" }]
    },
    "relatedTopics": {
        "top": [{ "topic": "Machine learning", "value": 100 }],
        "rising": [{ "topic": "Large language model", "value": "+2500%" }]
    },
    "interestByRegion": [
        { "region": "California", "value": 100 },
        { "region": "New York", "value": 92 }
    ]
}

Usage

Apify Console

1. Go to the Actor page
2. Enter your search terms
3. Configure location and time range
4. Click "Start"
5. Download results as JSON, CSV, or Excel

API

curl -X POST "https://api.apify.com/v2/acts/YOUR_USERNAME~google-trends-scraper/runs" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "searchTerms": ["typescript", "javascript"],
    "geo": "US",
    "timeRange": "today 12-m"
  }'

JavaScript

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });

const run = await client.actor('YOUR_USERNAME/google-trends-scraper').call({
    searchTerms: ['react', 'vue', 'angular'],
    geo: 'US',
    timeRange: 'today 12-m',
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Cost Optimization

• Use maxConcurrency: 1 to minimize proxy costs
• Shorter time ranges return faster
• Batch related keywords to reduce total runs

Limitations

• Maximum 5 search terms per run
• Google may rate-limit aggressive scraping
• Some data may not be available for low-volume terms

Claude Desktop MCP Server

This scraper exposes a Model Context Protocol (MCP) server that provides Google Trends tools directly to Claude Desktop.

Features

• Real Browser Fetching: Uses Playwright to bypass Google's anti-bot measures
• Rotating Proxies: Support for rotating residential proxies
• 13 Tools: Full suite of data fetching and analysis tools
• Analysis: Built-in momentum calculation, pattern detection, and hypothesis generation

Tools Included

1. Data Fetching: get_interest_over_time, get_trending_searches, get_realtime_trending, get_related_queries, get_related_topics, get_interest_by_region, compare_trends
2. Analysis: predict_trend, analyze_momentum, detect_patterns, generate_hypotheses, calculate_moving_averages, forecast_values

Installation

1. Build the project:

npm install
npm run build

2. Configure Claude Desktop (Settings -> Developer -> Edit Config):

{
  "mcpServers": {
    "google-trends": {
      "command": "node",
      "args": ["C:/path/to/trends_scraper/dist/mcp-server.js"],
      "env": {
        "PROXY_SERVER": "http://your-proxy.com:8080",
        "PROXY_USERNAME": "user",
        "PROXY_PASSWORD": "pass",
        "PROXY_ROTATE": "true"
      }
    }
  }
}

Proxy Configuration

To avoid being blocked by Google, use residential proxies. You can configure them via environment variables in your MCP config:

• PROXY_SERVER: URL of your proxy server (e.g., http://gate.smartproxy.com:7000)
• PROXY_USERNAME: Proxy username
• PROXY_PASSWORD: Proxy password
• PROXY_ROTATE: Set to true to rotate IP on every request

Support

For issues or feature requests, please open an issue on the Actor's GitHub repository.