Search Intent
Search Intent 使用信息型、导航型、商业型或交易型标签描述查询，并提供主要和次要意图的概率信号。这些分类可用于标注关键词清单、审查混合意图、校准内容提纲，以及把已准备的关键词分配到不同研究流程。
主要特性
- 按语言批量分类使用一种选定语言批量识别最多 1,000 个关键词；未提供语言时使用英语。
- 主要与次要意图信号返回概率最高的意图及其概率，并提供其他可能的意图标签和对应概率。
- 标准字段与完整记录从标准化的 keyword 和 search_intent 字段读取结果，并在 extra 中保留 keyword_intent 与 secondary_keyword_intents。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
keywords | 必填 | 必填的关键词列表，包含 1 到 1,000 个非空项，每个最长 80 个字符。 |
location_code | 可选 | 可选的正整数搜索市场位置代码。 |
location_name | 可选 | 可选的搜索市场名称，用于替代 location_code；填写后优先于 location_code。 |
language_code | 可选 | 可选的搜索语言代码，长度为 2 到 10 个字符。Playground 默认为 en。 |
language | 可选 | 可选的搜索语言名称，用于替代 language_code；填写后优先于 language_code。 |
results_limit | 可选 | 可选的结果数量上限，范围为 1 到 2,000。 |
如何使用
提交关键词列表以及可选的市场、语言和结果数量设置，然后从完成的异步任务中读取标准化意图记录。
- 准备 1 到 1,000 个非空关键词，每个不超过 80 个字符。
- 将 keywords 以及可选的市场、语言或 results_limit 字段 POST 到 /v1/seo/search-intent，并保存返回的 task_id。
- 轮询 /v1/tasks/{task_id}，直到任务成功或失败。
- 读取 data.results.items；has_more 为 true 时继续使用 next_cursor。
curl -X POST "https://api.socq.ai/v1/seo/search-intent" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keywords":["how to research keywords","buy seo software"],"language_code":"en"}'
# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items；has_more 为 true 时继续使用 next_cursor最佳使用场景
- 标注关键词清单： 结合关键词与主要意图，为已有关键词清单添加一致的意图标签。
- 审查混合意图： 对比主要与次要标签及其概率，识别可能对应多个搜索目标的关键词。
- 分配关键词研究流程： 按信息型、导航型、商业型或交易型整理输入关键词，再分配到不同研究流程。
使用建议
- 提交批次前删除空项和重复词，确保按输入数量计费的关键词都是实际需要分类的内容。
- 比较多个批次时保持市场和语言字段一致。
- 关键词存在混合意图时应同时检查次要意图概率，不要把主要标签理解为所有搜索者的统一结论。
- 处理没有分类结果的关键词，并在审查原始 keyword_intent 与 secondary_keyword_intents 对象时读取 extra。
相关 API
需要其他类型的 SEO 公开数据时，可以使用以下 API。
- Google Organic SERP API — 按一个 query 和市场获取实时 Google 结果页，返回标准化目标地址、排名、元素类型和完整结果详情。
- Keyword Difficulty API — 比较一批输入关键词的自然排名难度，为每个有可用数据的关键词返回标准化分数。
- Keyword Overview API — 为一批输入关键词补充可用的需求、付费竞争、难度、月度搜索和搜索意图信息。
- Keyword Search Volume API — 测量已知关键词可用的搜索量、CPC、付费竞争和月度搜索历史。
- Keywords for Site API — 根据一个网站生成相关关键词，并返回可用的需求指标、月度历史、市场上下文和完整来源记录。
- Keyword Suggestions API — 按一个种子 query 扩展包含原词的长尾词，并返回可用的需求指标、月度历史、意图信息和完整来源记录。
- Ranked Keywords API — 查找域名、子域名或页面已有排名的关键词，返回匹配 URL、位置、搜索指标、意图和完整来源元素。
- Related Keywords API — 围绕一个种子 query 沿相关搜索路径查找关键词，并返回深度控制、可用关键词指标、意图信息和完整来源记录。
- Relevant Pages API — 为一个域名整理已被搜索索引收录的页面，并返回自然与付费排名分布、估算流量和成本信息。