Keywords for Site
Keywords for Site 记录把网站主题与相关搜索词、搜索量、CPC、付费竞争、月度需求和分类信息关联起来。这些关键词及指标关系可用于发现网站主题、研究竞品、整理候选词，以及比较不同域名。
主要特性
- 按域名发现相关词输入单个网站域名即可获取与其主题相关的关键词建议，无需先准备种子词。
- 需求与付费搜索指标通过标准化的搜索量、CPC、付费竞争、竞争等级和月度搜索数据评估返回关键词。
- 完整关键词上下文从 extra 读取完整返回记录，其中保留可选的分类、难度、意图、趋势和其他未提升属性。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
target | 必填 | 必填的网站域名，用作主题来源。Playground 默认为 microsoft.com。 |
location_code | 可选 | 可选的正整数搜索市场位置代码。Playground 默认提交 2840。 |
location_name | 可选 | 可选的搜索市场名称，用于替代 location_code；填写后优先于 location_code。 |
language_code | 可选 | 可选的搜索语言代码，长度为 2 到 10 个字符。Playground 默认提交 en。 |
language | 可选 | 可选的搜索语言名称，用于替代 language_code；填写后优先于 language_code。 |
results_limit | 可选 | 1 到 1,000 的来源结果上限。Playground 按文档示例提交 5；省略时后端使用 100。 |
如何使用
提交一个域名以及市场、语言和结果数量设置，然后从完成的任务中读取标准化关键词记录。
- 选择一个域名目标、正整数 location_code、language_code，以及 1 到 1,000 的 results_limit。
- 将 payload POST 到 /v1/seo/keywords-for-site，并保存返回的 task_id。
- 轮询 /v1/tasks/{task_id}，直到任务成功或失败。
- 读取 data.results.items；has_more 为 true 时继续使用 next_cursor。
curl -X POST "https://api.socq.ai/v1/seo/keywords-for-site" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"target":"microsoft.com","location_code":2840,"language_code":"en","results_limit":5}'
# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items；has_more 为 true 时继续使用 next_cursor最佳使用场景
- 发现网站主题： 结合返回的关键词和分类，识别与已知网站相关的搜索主题。
- 研究竞品关键词： 输入竞品域名，并结合相关词、搜索量、CPC 和付费竞争整理研究词集。
- 比较不同域名的主题： 分别查询多个网站，并比较其返回的关键词集合、分类和需求指标。
使用建议
- 提交 target 前移除 http:// 和 https://，避免域名格式无效。
- 比较多次结果时应显式指定市场和语言，不要依赖供应商对省略字段的处理。
- 根据一次查询真正需要的最大结果数设置 results_limit，因为该接口没有 offset，无法请求后续来源窗口。
- 指标缺失时应按不可用处理，不要写成 0；标准字段没有所需属性时再检查 extra。
- 需要已观测排名位置或对应 URL 时改用 Ranked Keywords，不要把相关关键词建议当作排名数据。
相关 API
需要其他类型的 SEO 公开数据时，可以使用以下 API。
- Google Organic SERP API — 按一个 query 和市场获取实时 Google 结果页，返回标准化目标地址、排名、元素类型和完整结果详情。
- Keyword Difficulty API — 比较一批输入关键词的自然排名难度，为每个有可用数据的关键词返回标准化分数。
- Keyword Overview API — 为一批输入关键词补充可用的需求、付费竞争、难度、月度搜索和搜索意图信息。
- Keyword Search Volume API — 测量已知关键词可用的搜索量、CPC、付费竞争和月度搜索历史。
- Keyword Suggestions API — 按一个种子 query 扩展包含原词的长尾词，并返回可用的需求指标、月度历史、意图信息和完整来源记录。
- Ranked Keywords API — 查找域名、子域名或页面已有排名的关键词，返回匹配 URL、位置、搜索指标、意图和完整来源元素。
- Related Keywords API — 围绕一个种子 query 沿相关搜索路径查找关键词，并返回深度控制、可用关键词指标、意图信息和完整来源记录。
- Relevant Pages API — 为一个域名整理已被搜索索引收录的页面，并返回自然与付费排名分布、估算流量和成本信息。
- Search Intent API — 批量识别输入关键词的主要和次要搜索意图，并保留来源概率与完整记录。