跳转到主要内容
KEYWORD_VOLUME 按每个任务一个国家,返回每个关键词最近 12 个月的平均月搜索量、12 个月的逐月数值以及广告竞争度。

请求

参数

数据来源与国家

支持的国家为 KR 和 Google Ads 的国家定位目标,但有两个例外:CN 和 RU 返回 422 REGION_UNSUPPORTED,因为这两个国家的大部分搜索由百度和 Yandex 承担。没有数据来源的国家也返回同样的错误。完整列表请调用 GET /v1/capabilities?taskType=KEYWORD_VOLUME 并读取 countries.supported。

响应

例如:
示例只显示了十二个月中的两个月。 在 KR 中,每个月的数值是按 Naver 每日搜索趋势分配 Naver 30 天搜索次数得出的。趋势在这 30 天中覆盖不足 25 天时,searchVolume 为 null,monthlySearches 为空,last30Days 仍给出搜索次数。

限制与错误

  • 缺少或格式错误的 country、为空或超出数量的 keywords 数组,或超过 80 个字符的关键词,返回 422 VALIDATION_ERROR 并指出相应字段。
  • CN、RU 和没有数据来源的国家返回 422 REGION_UNSUPPORTED。
  • KEYWORD_VOLUME 忽略 markdown、rawResponse 和 searchQueries。它以 422 拒绝 html 和 analysis,以 400 拒绝 citationAnalysis;见不支持的标志。
  • 其他请求错误见错误。

相关内容