Related Keywords
相关关键词是通过“相关搜索”图谱连接的 query，并带有关系深度、搜索量、CPC、竞争、难度和意图等信号。这些关系和指标可用于发现相邻主题、扩展主题图谱和比较关键词候选项。
主要特性
- 相关搜索图谱扩展从一个种子词沿直接或递归的 query 关系展开，depth 可取 0 到 4，不要求结果包含原短语。
- 关键词指标对象为每个关联 query 返回可用的搜索量、CPC、付费竞争、月度历史、关键词难度和意图信息。
- 保留关系环境在 extra 中保留来源 depth、相关词路径、完整 keyword_data 和其它可变字段，便于解释图谱关系。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
query | 必填 | 必填的非空种子关键词或短语。一个任务接受一个 query。 |
location_code | 可选 | 正整数搜索市场代码；Playground 默认使用 2840。 |
language_code | 可选 | 搜索语言代码；Playground 默认使用 en。 |
depth | 可选 | 0 到 4 的关系深度；默认值 1 返回直接关联的 query。 |
results_limit | 可选 | 请求返回 1 到 1,000 条相关关键词的上限，实际结果可以更少。 |
offset | 可选 | 获取当前结果窗口前要跳过的来源记录数量，从 0 开始计算。 |
如何使用
提交一个种子 query，设置关系深度、市场和有界结果窗口，再从已完成的异步任务读取相关关键词记录。
- 选择一个非空 query、location_code、language_code、0 到 4 的 depth、1 到 1,000 的 results_limit，以及不小于 0 的 offset。
- 将请求体 POST 到 /v1/seo/related-keywords，并保存返回的 task_id。
- 轮询 /v1/tasks/{task_id}，直到任务成功或返回失败。
- 读取 data.results.items；has_more 为 true 时继续请求返回的 next_cursor。
curl -X POST "https://api.socq.ai/v1/seo/related-keywords" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"keyword research","location_code":2840,"language_code":"en","depth":1,"results_limit":100,"offset":0}'
# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items，并在 has_more 为 true 时继续使用 next_cursor最佳使用场景
- 相邻主题发现： 利用返回的 query 文本和关系信息，查找不必包含种子短语的关联主题。
- 主题图谱扩展： 比较 depth 和相关词路径，将一个种子词从直接相邻词扩展为更广的 query 图谱。
- 关键词候选评估： 结合相关词与可用的需求、成本、竞争、难度、月度历史和意图，整理便于复核的候选集合。
使用建议
- 需要直接关系时从 depth 1 开始；只有在接受更大且直接相关性可能较低的候选集合时，才提高 depth。
- 如果每条结果都必须保留种子词，请改用 Keyword Suggestions，因为相关 query 可以使用完全不同的表达。
- 比较不同结果窗口时固定 query、location_code、language_code 和 depth，以保持关系与市场环境一致。
- 将 offset 视为要跳过的记录数量而不是页码，并按计划略过的来源记录数增加它。
- 优先读取标准化的 keyword、metrics、monthly_searches 和 search_intent，再从 extra 检查来源深度与关系路径。
- 不要根据图谱邻近关系推断意图相同，并允许可选指标和 extra 中的可变字段缺失。
相关 API
需要其他类型的 SEO 公开数据时，可以使用以下 API。
- Keyword Difficulty API — 比较一批输入关键词的自然排名难度，为每个有可用数据的关键词返回标准化分数。
- Keyword Overview API — 为一批输入关键词补充可用的需求、付费竞争、难度、月度搜索和搜索意图信息。
- Keyword Search Volume API — 测量已知关键词可用的搜索量、CPC、付费竞争和月度搜索历史。
- Keyword Suggestions API — 按一个种子 query 扩展包含原词的长尾词，并返回可用的需求指标、月度历史、意图信息和完整来源记录。