主题
点击流数据 API 概览
点击流数据 API 基于真实用户点击流行为,提供搜索量及洞察数据,可作为传统广告平台搜索量数据的补或替代来源。该系列接口通过对多来源点击流数据进行处理和归一化,生成可直接用于研究、市场分析与 SEO 决策的指标。
本系列 API 提供以下接口:
搜索量
- 路径:
/v3/keywords_data/clickstream_data/global_search_volume/live/ - 可在单次请求中查询最多 1000 个的点击流搜索量,并返回在可用地区中的地域分布数据。
- 路径:
本平台搜索量
- 路径:
/v3/keywords_data/clickstream_data/dataforseo_search_volume/live/ - 可在单次请求中查询最多 1000 个的搜索量数据。返回值会基于 Bing 搜索量数据或点击流数据进行归一化处理。
- 路径:
批量点击流搜索量
- 路径:
/v3/keywords_data/clickstream_data/bulk_search_volume/live/ - 可在单次实时请求中获取最多 1000 个的点击流搜索量,并提供最长 12 个月的月度历史数据。
- 路径:
地区和语言
- 路径:
/v3/keywords_data/clickstream_data/locations_and_languages/ - 返回点击流数据 API 支持的地区和语言列表,可用于确定查询时可传的
location_code、语言等参数。
- 路径:
数据计算方式
本接口的数据基础为经过筛选和处理的点击流数据。平台会结合多个影响因素计算校正系数,将原始点击行为转换为可用于业务分析的指标,例如搜索量、地域搜索分布及历史月度趋势。
点击流指标反映的是用户搜索与点击行为,因此适合用于补传统覆盖不足的市场、地区或长尾数据。
数据获取方式
点击流数据 API 支持 Live(实时) 查询模式。
调用实时接口时,无需执行异步任务常见的“ POST 创建任务、再 GET 获取结果”流程。请求提交后,接口会在响应中直接返回结果。
调用限制
平台限流以认证说明中的 30/60/120 次/分钟规则为准。
- 如需提高调用限额,请联系本平台技术支持。
计费说明
不同点击流数据接口及查询参数的计费可能不同。扣费以响应头 X-SeerMarTech-Charge-CNY 为准。
建议在批量调用前,根据单次请求中的数量、地区范围和历史数据需求评估调用量,并在应用侧记录响应头中的费用。
接口选择建议
| 业务需求 | 推荐接口 |
|---|---|
| 查询多个国家或地区的搜索量及地域分布 | /v3/keywords_data/clickstream_data/global_search_volume/live/ |
| 获取归一化后的搜索量 | /v3/keywords_data/clickstream_data/dataforseo_search_volume/live/ |
| 获取最近 12 个月的月度搜索量趋势 | /v3/keywords_data/clickstream_data/bulk_search_volume/live/ |
| 查询可用的地区和语言参数 | /v3/keywords_data/clickstream_data/locations_and_languages/ |
实用场景
- 评估市场需求:查询目标在不同国家和地区的点击流搜索量,为 SEO 选词、立项和广告投放提供需求依据。
- 发现区域化增长机会:比较同一在不同地域的搜索量分布,识别高潜力市场并制定本地化策略。
- 追踪季节性搜索趋势:使用历史月度搜索量数据识别旺季、淡季和异常波动,优化发布时间与营销预算安排。
- 补长尾词研究数据:针对传统搜索量来源覆盖有限的长尾,利用点击流指标扩展库并提升主题覆盖率。
- 构建优级模型:将点击流搜索量与排名、转化率、竞争度等指标结合,为分组和资源排序。