Google Trends Scraper

Google Trends API for Python（pytrends 替代方案）

将 Google Trends 数据导入 Python：包括随时间变化的兴趣度、按地区划分的兴趣度、热门和飙升的相关搜索，以及简单的趋势指标。你还可以在同一尺度上比较 10、50 甚至 100 多个关键词。Google Trends 网站最多只能比较 8 个（经典版 Explore 中为 5 个）。

pytrends 于 2025 年 4 月归档，并且经常因 429 Too Many Requests 而失效。Google 于 2025 年 7 月宣布推出官方 Trends API，但目前仍处于 Alpha 阶段，访问权限有限且需申请。这些示例使用托管式抓取工具：Apify 上的 Google Trends Scraper，由它为你处理 Google 的会话 Cookie 和速率限制。

教程：在 Python 中使用 Google Trends（无需 pytrends），以及如何比较超出 Google 允许数量的关键词。教程介绍了网站背后的两个端点、串联比较的方法，以及数据的形式。

示例输出：在 Programming 类别中，2021 至 2026 年间，大多数语言的搜索兴趣度下降了 40-68%。此图使用 examples/compare_keywords.py 和 matplotlib 生成。

快速开始

1. 创建免费的 Apify 账户。免费套餐每月包含 $5 额度，约可用于 2,500 个关键词。无需信用卡。
2. 在 Apify Console 的 Settings > API & Integrations 中复制 API token。
3. 运行示例：

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/compare_keywords.py	在同一共享尺度上比较 10 个关键词，输出搜索份额和趋势，并保存为 CSV
examples/keyword_report.py	显示每个关键词的趋势、峰值、最繁忙月份、热门地区和飙升搜索
examples/plot_trends.py	使用 matplotlib 绘制多个关键词随时间变化的兴趣度
examples/raw_endpoints.py	展示 trends.google.com 背后的两个 JSON 端点，无需任何库。适用于少量关键词。

sample-output/programming-languages-5y.csv 展示了 compare_keywords.py 生成的 CSV。

每个关键词可获取的数据

• interestOverTime：完整的时间序列（0-100），未结束的最后一周或一天会标记为 partial
• interestByRegion：该关键词最受欢迎的国家、州或地区
• relatedQueriesTop 和 relatedQueriesRising，包括细分结果
• averageInterest、latestInterest、peakInterest、peakDate
• trend（上升、下降或稳定）和 trendChangePercent：将该时间段的最后一个季度与第一个季度进行比较
• busiestMonth：适用于约一年或更长的时间段
• shareOfSearch：在同一共享尺度上比较关键词时提供

如何比较大量关键词

Google 的 Trends API 每次请求最多比较 5 个关键词（网站最多显示 8 个），并将每次请求的最高点设为 100。若要比较更多关键词，抓取工具会：

1. 将关键词分成每组 5 个并发起请求；
2. 将每组中搜索量最高的关键词（该组的“领头关键词”）与其他组的领头关键词进行比较，每次比较 5 个，并保留 1 个重叠的领头关键词，以便串联任意数量的分组；
3. 通过各组的领头关键词对所有分组重新缩放，然后重新缩放全部结果，使整体最高点为 100。

Google 会将数值四舍五入为整数，因此搜索量较小的关键词与搜索量巨大的关键词放在一起时，仍可能显示为 0。为获得最佳精度，请比较规模相近的关键词。

通过 AI 助手（MCP）使用

要让 Claude、Cursor、VS Code 或其他 MCP 客户端帮你查询 Google Trends，请添加此 MCP 服务 URL：https://mcp.apify.com/?tools=ralfij/google-trends-scraper。客户端提示时，请登录 Apify，或将你的 Apify API 令牌作为 Authorization: Bearer <token> 发送。运行费用计入你自己的 Apify 账户。

说明

• 这些示例中使用的 Google Trends Scraper 是我开发的，请留意这一点。raw_endpoints.py 展示了如何自行实现。
• 按关键词计费，无需订阅；请参阅Actor 页面。你还可以在其示例任务中找到更多现成的搜索。
• 与 Google 无关联，也未获其认可或赞助。Google Trends 是 Google LLC 的商标。

许可证

MIT