Google Trends Scraper

Official registry Search and web

Google Trends for any number of keywords on one scale: interest over time, regions, rising queries.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code
claude mcp add --transport http google-trends-scraper 'https://mcp.apify.com/?tools=ralfij/google-trends-scraper' --header 'Authorization: <Optional: "Bearer <your Apify API token>". MCP clients that support OAuth can sign in to Apify instead. Runs are billed to your Apify account.>'
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "google-trends-scraper": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=ralfij/google-trends-scraper",
            "headers": {
                "Authorization": "<Optional: \"Bearer <your Apify API token>\". MCP clients that support OAuth can sign in to Apify instead. Runs are billed to your Apify account.>"
            }
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Google Trends API for Python (a pytrends alternative)
  2. Quick start
  3. Examples
  4. What you get per keyword
  5. How comparing many keywords works
  6. Use it from AI assistants (MCP)
  7. Notes
  8. License

Get Google Trends data into Python: interest over time, interest by region, top and rising related searches, and simple trend metrics. You can also compare 10, 50 or 100+ keywords on one scale. The Google Trends website stops at 8 (5 in classic Explore).

pytrends was archived in April 2025 and often fails with 429 Too Many Requests. Google announced an official Trends API in July 2025, but it is an alpha with limited, application-based access. These examples use a hosted scraper instead, the Google Trends Scraper on Apify, which deals with Google's session cookies and rate limits for you.

Tutorial: Google Trends in Python without pytrends, and how to compare more keywords than Google allows. It covers the two endpoints behind the website, the trick for linking comparisons, and what the data looks like.

Example output: search interest in the Programming category fell 40-68% for most languages between 2021 and 2026. Made with examples/compare_keywords.py and matplotlib.

Quick start

  1. Create a free Apify account. The free plan includes $5 of credit every month, which covers about 2,500 keywords. No credit card needed.
  2. Copy your API token from Settings > API & Integrations in Apify Console.
  3. Run an example:
pip install -r requirements.txt
export APIFY_TOKEN=your-token        # Windows: set APIFY_TOKEN=your-token
python examples/compare_keywords.py
keyword       share %  average  trend
java             29.4     63.7  falling (-48.8%)
c++              23.8     51.6  stable (-7.1%)
python           15.8     34.3  falling (-43.7%)
...

Examples

FileWhat it does
examples/compare_keywords.pyCompares 10 keywords on one shared scale, prints share of search and trend, and saves a CSV
examples/keyword_report.pyTrend, peak, busiest month, top regions and rising searches per keyword
examples/plot_trends.pyPlots interest over time for several keywords with matplotlib
examples/raw_endpoints.pyThe two JSON endpoints behind trends.google.com, with no library at all. Good for a few keywords.

sample-output/programming-languages-5y.csv shows the CSV from compare_keywords.py.

What you get per keyword

  • interestOverTime: the full time series (0-100), with the unfinished last week or day marked partial
  • interestByRegion: countries, states or regions where the keyword is most popular
  • relatedQueriesTop and relatedQueriesRising, including breakouts
  • averageInterest, latestInterest, peakInterest, peakDate
  • trend (rising, falling or stable) and trendChangePercent: the last quarter of the period against the first quarter
  • busiestMonth for periods of about a year or longer
  • shareOfSearch when you compare keywords on one shared scale

How comparing many keywords works

Google's Trends API compares at most 5 keywords per request (the website shows up to 8) and scales each request so its highest point is 100. To compare more, the scraper:

  1. requests the keywords in groups of 5;
  2. compares the most searched keyword of each group (the group "leader") with the other leaders, 5 at a time with one leader of overlap, so any number of groups can be chained;
  3. rescales every group through its leader, then rescales everything so the highest point overall is 100.

Google rounds to whole numbers, so a tiny keyword next to a huge one can still show as 0. Compare keywords of a similar size for the best precision.

Use it from AI assistants (MCP)

To let Claude, Cursor, VS Code or another MCP client look up Google Trends for you, add this MCP server URL: https://mcp.apify.com/?tools=ralfij/google-trends-scraper. Sign in to Apify when the client asks, or send your Apify API token as Authorization: Bearer <token>. Runs are billed to your own Apify account.

Notes

  • I built the Google Trends Scraper used in these examples, so keep that in mind. raw_endpoints.py shows how to do it yourself.
  • Pricing is per keyword with no subscription; see the actor page. More ready-made searches are on its example tasks.
  • Not affiliated with, endorsed by or sponsored by Google. Google Trends is a trademark of Google LLC.

License

MIT

Frequently asked questions

What is Google Trends Scraper?

Google Trends for any number of keywords on one scale: interest over time, regions, rising queries.

How do I install Google Trends Scraper?

It runs as a remote server. In Claude Code: claude mcp add --transport http google-trends-scraper 'https://mcp.apify.com/?tools=ralfij/google-trends-scraper' --header 'Authorization: <Optional: "Bearer <your Apify API token>". MCP clients that support OAuth can sign in to Apify instead. Runs are billed to your Apify account.>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Google Trends Scraper need an API key?

Yes. It expects Authorization, which you set in its configuration.

Is Google Trends Scraper open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Google Trends Scraper?

It is published by RalfIJ. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.