Keywords Data API 概览

Keywords Data API 用于研究与分析，提供 Google 和 Bing 两类数据源。返回结果会根据请求中指定的语言、地区及各端点专属参数而变化。

本概览页不对应单一 API 的 HTTP 方法或请求路径；请根据功能调用以下 /v3/... 容路径。

数据源与端点

Google

功能	接口路径	说明
搜索量	/v3/keywords_data/google_ads/search_volume/live/	查询一个或多个的搜索量、竞争度、出价等指标。
网站	/v3/keywords_data/google_ads/keywords_for_site/live/	获取与指定网站或页面的数据。
拓展	/v3/keywords_data/google_ads/keywords_for_keywords/live/	根据种子获取建议。
广告流量	/v3/keywords_data/google_ads/ad_traffic_by_keywords/live/	估算对应的广告流量及广告投放指标。
Google Trends 探索	/v3/keywords_data/google_trends/explore/task_post/	创建趋势探索任务，分析热度随时间、地区和主题的变化。

> Google Ads 数据基于最新版 Google Ads API。若仍在使用旧版 Google AdWords 容接口，请迁移至 /v3/keywords_data/google_ads/ 下的接口。

Bing

功能	接口路径	说明
搜索量	/v3/keywords_data/bing/search_volume/live/	查询 Bing 搜索中的搜索量及指标。
网站	/v3/keywords_data/bing/keywords_for_site/live/	获取与指定网站的 Bing 数据。
拓展	/v3/keywords_data/bing/keywords_for_keywords/live/	根据种子词获取 Bing 建议。
表现	/v3/keywords_data/bing/keyword_performance/live/	获取在 Bing 广告体系中的表现指标。

完整端点列表请参考文档中的 /v3/keywords_data/endpoints/。

数据限制与合规要求

Google 和 Bing 数据源均受广告政策限制。涉及以下或类似受限类别的，可能无法返回数据：

• 武器；
• 烟草；
• 药物及毒品；
• 暴力；
• 恐怖主义；
• 受广告平台政策限制的。

**批量请求注意事项：**如果一个批次中受限，即使有一个不符合政策要求，整个批次都可能无法返回数据。建议在提交前按主题或风险等级拆分，以降低单个受限词影响整批请求的风险。

数据获取方式

数据接口支持 Live 和 Standard 两种结果获取模式。不同端点支持的方式可能不同，请以端点文档为准。

Live 实时模式

Live 模式适用于需要同步获取结果的场景。

特点：

• 使用一次请求即可获取结果；
• 无需分别创建任务和轮询任务结果；
• 适合在线、实时查询、交互式分析；
• 通常比异步模式收费更高。

常见 Live 接口示例：

• /v3/keywords_data/google_ads/search_volume/live/
• /v3/keywords_data/google_ads/keywords_for_keywords/live/
• /v3/keywords_data/bing/search_volume/live/

Standard 异步模式

Standard 模式适用于无需立即获得结果、但需要控制成本或处理较大任务量的场景。

型流程如下：

1. 使用 Task POST 接口提交任务；
2. 等平台完成数据采集；
3. 通过 Tasks Ready 接口获取已完成任务的 id 列表；
4. 使用 Task GET 接口按任务 id 获取结果。

创建异步任务时，还可以指定以下回调参数：

参数	说明
pingback_url	任务完成后通知指定 URL；接收方可再请求结果接口获取数据。
postback_url	任务完成后将结果直接推送至指定 URL。

当需要批量创建多个任务时，建议调用对应的 Tasks Ready 接口集中获取已完成任务 ID，再按需调用 Task GET 接口拉取各任务结果。

请求频率限制

平台限流以认证说明中的 30/60/120 次/分钟规则为准**。

如业务需要更高并发额度，请联系技术支持申请提升限额。对于大批量请求，建议：

• 控制单次请求中的数量；
• 按业务主题、语言或地区拆分任务；
• 对异步任务采用队列与回调机制；
• 针对失败请求实施退避重试；
• 避在短时间重复提交相同、地区和语言组合。

计费说明

数据接口的费用取决于以下因素：

• 数据获取方式：Live 或 Standard；
• 任务执行优级；
• 调用的端点；
• 请求中的数量及参数。

扣费以响应头 X-SeerMarTech-Charge-CNY 为准。

测试环境

可通过 Sandbox 环境测试数据接口的请求格式、参数校验和响应结构。Sandbox 返回的数据用于开发调试，不应作为正式业务分析依据。

实用场景

• **筛选高潜力：**按国家、语言和搜索引擎查询搜索量与竞争度，为选题和 SEO 库建设确定优级。
• **拓展长尾词集：**基于核心产品词调用接口，发现用户搜索意图明确的长尾词，提高覆盖率与自然流量机会。
• **分析竞品布局：**竞品域名或页面获取，识别覆盖的主题、产品需求与潜在流量缺口。
• **评估广告投放机会：**结合广告流量、出价和竞争指标，筛选适合搜索广告测试的高商业价值词。
• **监测搜索趋势变化：**通过趋势探索接口比较在不同时间和地区的热度变化，为季节性营销、库存规划和发布排期提供依据。