Keyword Search Volume API

Keyword Search Volume

主要特性

• 批量测量已知关键词一次请求可测量 1 到 1,000 个已准备的关键词，每项最多 80 个字符。
• 搜索需求字段为有测量数据的关键词返回可用的 search_volume 和 monthly_searches 观察值。
• 付费市场信息将可用的 CPC、competition、competition_level、competition_index 和可选出价字段关联到对应搜索词。
• 标准化记录与来源上下文把稳定的需求字段提升到 metrics，同时在 extra 中保留完整返回行及可选市场和出价元数据。

参数

如何使用

提交限定数量的已知关键词，并可附带市场和语言设置，然后从异步结果记录中读取标准化需求字段。

1. 准备 1 到 1,000 个非空的已知关键词，每项不超过 80 个字符。
2. 将 keywords POST 到 /v1/seo/keyword-search-volume；需要可复现的特定市场结果时加入 location_code 和 language_code，并保存返回的 task_id。
3. 轮询 /v1/tasks/{task_id}，直到任务成功或返回失败。
4. 读取 data.results.items；has_more 为 true 时继续使用 next_cursor，未提升的来源字段可从 extra 获取。

curl -X POST "https://api.socq.ai/v1/seo/keyword-search-volume" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keywords":["keyword research","seo analytics"],"location_code":2840,"language_code":"en"}'

# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items，并在 has_more 为 true 时继续使用 next_cursor

最佳使用场景

• 比较已准备词表的需求： 把 search_volume 关联到已知词表，并在一致搜索环境中比较预估需求。
• 检查月度季节变化： 使用年份、月份和 search_volume 观察值分析测量需求随时间发生的变化。
• 研究付费搜索环境： 比较各测量关键词的 CPC、competition、competition_index 和可选出价信息。

使用建议

• 适合批量处理时，将已准备的搜索词合并为不超限的一批，因为固定 24 积分按请求收取，而不是按返回行收取。
• 比较不同批次时明确发送并保持相同的 location_code 和 language_code；只有需要全球范围时才同时省略两者。
• 不要提交 results_limit，因为该操作由 keywords 数组控制批次，且该操作没有已记录的 limit 控制。
• 按 keyword 匹配返回行，并将缺失记录或空字段理解为没有可用数据，而不是已确认需求为零。
• 将 CPC 和 competition 理解为付费搜索信号，而不是自然排名难度；同时注意相近变体可能共享聚合搜索量。

相关 API