主题
Google Trends API 概述
本接口用于获取的相对热度、主题及搜索词数据。实时查询使用 POST /v3/keywords_data/google_trends/explore/live/;标准异步查询需依次调用 POST /v3/keywords_data/google_trends/explore/task_post/ 和 GET /v3/keywords_data/google_trends/explore/task_get/。
Google Trends 数据基于 Google Trends 的「探索」功能,可帮助您分析在指定时间、地区及搜索渠道中的相对度。支持的数据:
- 热度趋势:指定时间范围的相对热度,最高热度值为基准。
- 地区热度分布:在不同国家、地区或城市中的相对热度。
- 主题:搜索指定的用户也的主题。
- 搜索词:搜索指定的用户也搜索过的。
一次请求可指定多个进行相对热度对比,最多支持同时比较 5 个。
目前支持以下搜索数据源:
- Google 搜索
- Google 新闻
- Google 图片
- Google 购物
- YouTube
数据获取方式
本接口支持实时模式和标准异步模式。
实时模式
实时模式适用于需要立即返回结果的业务场景。提交请求后,本平台会同步返回查询结果,无需轮询任务状态。
请求接口:
text
POST /v3/keywords_data/google_trends/explore/live/实时请求的 JSON 请求体应使用数组格式:
json
[
{
"keywords": [
"seo tools",
"keyword research"
],
"location_name": "United States",
"language_name": "English"
}
]标准异步模式
标准模式适用于无需实时返回结果、需要批量提交趋势分析任务的场景。该模式任务创建和结果获取两个步骤。
- 通过任务提交接口创建查询任务;
- 等本平台完成数据采集;
- 使用任务 ID 获取对应结果。
创建任务:
text
POST /v3/keywords_data/google_trends/explore/task_post/获取任务结果:
text
GET /v3/keywords_data/google_trends/explore/task_get/创建任务时,也可以传以下回调参数:
| 参数 | 类型 | 说明 |
|---|---|---|
pingback_url | string | 任务完成后,本平台向该地址发送完成通知。 |
postback_url | string | 任务完成后,本平台将任务结果直接推送至该地址。 |
若一次创建了多个任务,可调用已完成任务列表接口获取完成任务的 id,再逐个获取任务结果。
text
GET /v3/keywords_data/google_trends/explore/tasks_ready/请求频率限制
默认,Google 平台限流以认证说明中的 30/60/120 次/分钟规则为准**。
如需提高调用额度,请联系平台支持人员。对于高并发或大批量任务,建议采用标准异步模式,并结合 tasks_ready 接口、pingback_url 或 postback_url 管理任务完成状态。
计费说明
不同查询方式、数据范围及请求参数可能对应不同费用。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。
您也可以通过以下接口查询账户用量及余额等信息:
text
GET /v3/appendix/user_data/实用场景
- 比较品牌与竞品热度:同时提交多个品牌,识别市场度变化及竞品增长趋势。
- 发现季节性需求波动:按时间范围查询核心热度,为节假日营销、排期和库存规划提供依据。
- 定位区域市场机会:分析在不同国家、地区或城市中的热度分布,本地化投放与区域 SEO 策略制定。
- 挖掘选题与长尾词:利用主题和搜索词,扩选题库及词库。
- 评估渠道搜索意图:对比 Google 搜索、新闻、图片、购物和 YouTube 中的趋势数据,确定更适合的与投放渠道。