关键词研究工作流
专门的关键词研究工作流，使用YepAPI端点发现、评估和优先排序关键词。
使用的端点
| 端点 | 费用 | 用途 |
|---|---|---|
POST /v1/seo/keywords/ideas | $0.03 | 根据种子关键词获取关键词建议 |
POST /v1/seo/keywords/related | $0.03 | 获取与种子关键词相关的关键词 |
POST /v1/seo/keywords | $0.15 | 批量获取关键词指标（搜索量、CPC、难度、意图） |
POST /v1/seo/keyword-gap | $0.04 | 分析两个域名间的关键词差距 |
工作流
步骤1：生成关键词创意
从种子关键词开始，调用 POST /v1/seo/keywords/ideas。
{
"keyword": "项目管理",
"location": "us"
}
返回：基于种子关键词的建议——内容角度和长尾变体。
步骤2：查找相关关键词
使用 POST /v1/seo/keywords/related 进行扩展。
{
"keyword": "项目管理",
"location": "us"
}
返回：语义相关的术语——更宽泛和更具体的变化。
步骤3：评估关键词指标
使用所有候选关键词调用 POST /v1/seo/keywords。
{
"keywords": ["项目管理软件", "项目管理工具", "最好的项目管理应用"],
"location": "us"
}
返回：搜索量、CPC、关键词难度、搜索意图（信息型/商业型/交易型）、12个月趋势。
步骤4：关键词差距分析（可选）
如果用户有域名和竞争对手信息，则调用 POST /v1/seo/keyword-gap。
{
"domain": "example.com",
"competitor": "competitor.com"
}
返回：竞争对手排名而用户未排名的关键词——潜在的未开发机会。
步骤5：优先排序关键词
呈现按机会分数排序的优先级关键词列表：
- 高机会 — 高搜索量 + 低难度
- 按意图分组 — 信息型、导航型、商业型、交易型
- 标记季节性关键词 — 根据趋势数据记录12个月模式
规则
- 从宽泛关键词开始，用指标逐步缩小范围
- 按搜索意图分组：信息型、导航型、商业型、交易型
- 使用趋势数据（12个月模式）标记季节性关键词
- 批量调用关键词指标请求 — 每请求最多100个关键词（$0.15）比单独查询更便宜
错误处理
NO_CREDITS(402) — 告知用户在 https://yepapi.com/dashboard 添加积分UPSTREAM_ERROR(502) — 重试一次；如果再次失败，则跳过该步骤并记录VALIDATION_ERROR(400) — 检查关键词格式；关键词不能为空字符串RATE_LIMITED(429) — 等待并重试；请遵守Retry-After头部信息