Google Trends (via Apify)

السجل الرسمي البحث والويب

Google Trends data for AI agents: interest over time, regions, rising queries and trending searches.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code
claude mcp add --transport http google-trends-via-apify 'https://mcp.apify.com/?tools=automationnation/google-trends-scraper' --header 'Authorization: <Your Apify API token, sent as '\''Bearer <token>'\''. Get it at https://console.apify.com/settings/integrations (free account).>'
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "google-trends-via-apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=automationnation/google-trends-scraper",
            "headers": {
                "Authorization": "<Your Apify API token, sent as 'Bearer <token>'. Get it at https://console.apify.com/settings/integrations (free account).>"
            }
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Google Trends Scraper & API: keyword trends and Trending now
  2. Quick facts
  3. Example input
  4. Run it from code
  5. Use it with AI agents (MCP)
  6. FAQ
  7. More from AutomationNation

Google Trends Scraper is an Apify Actor that extracts Google Trends data for any keywords and regions — interest over time, interest by region and city, rising and top related queries, and the trending searches for any country — at $1 per 1,000 keyword reports. It works as a Google Trends API: call it from code, schedule it for trend alerts, or let AI agents use it through Apify's MCP server.

Price: $1 per 1,000 keyword reports ($0.27–$0.90 on paid plans) · $0.50 per 1,000 trending searches · Run it: https://apify.com/automationnation/google-trends-scraper · Guide: https://retracn.github.io/automationnation-actors/google-trends-scraper/

Quick facts

  • One row per keyword: the 0–100 timeline with dates, trend direction and change %, peak date, a one-sentence summary, interest by country / state / city, and top and rising related queries with growth % and Breakout flags.
  • Migrating from pytrends? The open-source pytrends-cloud package (github.com/retracn/pytrends-cloud) keeps pytrends' TrendReq interface and runs on this Actor: change one import, no more 429 errors.
  • Trending now for any country: search volume, growth %, start time, related searches and news articles; Only new trends mode turns scheduled runs into alerts.
  • Compare up to 5 terms like Google Trends, or any number of terms on one scale (rescaled through a shared anchor term).
  • Every Google Trends option: any country or subregion, past hour to 2004–present or custom dates, category, and web / image / news / YouTube / Shopping search; input as keywords, Google Trends URLs or a Google Sheet.
  • Price: $1 per 1,000 keyword reports and $0.50 per 1,000 trending searches on the Free plan (lower on paid plans); keywords with too little search volume are free. Apify's free $5 monthly credit covers about 5,000 keyword reports.
  • Same input fields as apify/google-trends-scraper, and every row also includes that Actor's output fields.
  • Node.js? The open-source google-trends-api-cloud package (github.com/retracn/google-trends-api-cloud) keeps the google-trends-api npm API and JSON, runs on this Actor, and makes dailyTrends and realTimeTrends work again.

Example input

{
  "searchTerms": [
    "chatgpt",
    "gemini",
    "claude ai"
  ],
  "geo": "US",
  "timeRange": "today 12-m"
}

Run it from code

REST API

curl -X POST "https://api.apify.com/v2/acts/automationnation~google-trends-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"searchTerms": ["chatgpt", "gemini", "claude ai"], "geo": "US", "timeRange": "today 12-m"}'

Python — see examples/python_example.py

# pip install apify-client
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("automationnation/google-trends-scraper").call(run_input={
  "searchTerms": [
    "chatgpt",
    "gemini",
    "claude ai"
  ],
  "geo": "US",
  "timeRange": "today 12-m"
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item.get("searchTerm"), item.get("trendDirection"), item.get("changePercent"), item.get("summary"))

JavaScript — see examples/node_example.mjs

// npm install apify-client
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('automationnation/google-trends-scraper').call({
  "searchTerms": [
    "chatgpt",
    "gemini",
    "claude ai"
  ],
  "geo": "US",
  "timeRange": "today 12-m"
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
for (const item of items) console.log(item.searchTerm, item.trendDirection, item.changePercent, item.summary);

Use it with AI agents (MCP)

Hosted MCP server URL (Claude, ChatGPT, Cursor and other clients with remote MCP support):

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

Local config for Claude Desktop / Cursor — mcp/claude_desktop_config.json:

{
  "mcpServers": {
    "google-trends-scraper": {
      "command": "npx",
      "args": [
        "-y",
        "@apify/actors-mcp-server",
        "--tools",
        "automationnation/google-trends-scraper"
      ],
      "env": {
        "APIFY_TOKEN": "YOUR_APIFY_TOKEN"
      }
    }
  }
}

FAQ

Is there an official Google Trends API? Google opened an official Google Trends API to a small group of alpha testers in 2025. For everyone else, Google Trends Scraper on Apify provides Google Trends data through Apify's REST API, Python and JavaScript clients, integrations and MCP.

What does Google Trends Scraper return? For each keyword: interest over time (0–100 with dates), trend direction, change %, peak date, a one-sentence summary, interest by region and city, and top and rising related queries. Trending now rows include search volume, growth %, start time, related searches and news articles.

Can it compare more than 5 keywords? Yes. With Compare all search terms on one scale, terms are batched around a shared anchor term and rescaled so any number of terms sit on one 0–100 scale.

How much does it cost? $1 per 1,000 keyword reports and $0.50 per 1,000 trending searches on Apify's Free plan, less on paid plans. Keywords without enough search volume and failed searches are free.

Can I switch from apify/google-trends-scraper? Yes. Keep your input (searchTerms, isMultiple, timeRange, customTimeRange, geo, category, startUrls, spreadsheetId, maxItems) and change the Actor ID; rows keep that Actor's field names next to the cleaner ones.

More from AutomationNation


This repository holds usage examples. The scraper itself runs on the Apify platform; you need a free Apify account and API token. Examples are MIT licensed.

الأسئلة الشائعة

ما هو Google Trends (via Apify)؟

Google Trends data for AI agents: interest over time, regions, rising queries and trending searches.

كيف أثبّت Google Trends (via Apify)؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http google-trends-via-apify 'https://mcp.apify.com/?tools=automationnation/google-trends-scraper' --header 'Authorization: <Your Apify API token, sent as '\''Bearer <token>'\''. Get it at https://console.apify.com/settings/integrations (free account).>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Google Trends (via Apify) إلى مفتاح API؟

نعم. يتطلب Authorization، وتضبطها في إعداداته.

هل Google Trends (via Apify) مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Google Trends (via Apify)؟

ينشره retracn. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.