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;见不支持的标志。- 其他请求错误见错误。
相关内容
- Prompt Research:把一个主题转换为要追踪的提示词
- 地区与位置