竞争对手研究工作流
使用 YepAPI 端点进行域名间的竞争分析。
使用的端点
| 端点 | 费用 | 用途 |
|---|---|---|
POST /v1/seo/domain/overview | $0.01 | 流量、关键词、反向链接、域名排名 |
POST /v1/seo/competitors | $0.04 | 按关键词重叠度找出 SEO 竞争对手域名 |
POST /v1/seo/keyword-gap | $0.04 | 两个域名之间的关键词差距分析 |
工作流
步骤 1：域名概览
对用户的域名运行 POST /v1/seo/domain/overview。
{
"domain": "example.com"
}
返回：自然流量、总关键词数、反向链接数量、域名排名。
步骤 2：发现竞争对手
对用户的域名运行 POST /v1/seo/competitors。
{
"domain": "example.com"
}
返回：竞争对手域名及其关键词重叠百分比和流量估算。
步骤 3：比较主要竞争对手
对排名前 2-3 的竞争对手，每个都运行 POST /v1/seo/domain/overview。
{
"domain": "competitor.com"
}
比较：流量、关键词数量、反向链接概况、域名排名。
步骤 4：关键词差距分析
在用户域名与主要竞争对手之间运行 POST /v1/seo/keyword-gap。
{
"domain": "example.com",
"competitor": "competitor.com"
}
返回：竞争对手有排名但用户没有的关键词——按搜索量和难度排序。
步骤 5：呈现发现结果
- 谁整体上表现更好（流量、权威性）
- 关键词差距在哪里（用户缺少的高价值词条）
- 下一步应针对什么（按机会优先级：高搜索量 + 低难度）
规则
- 从域名概览开始——费用最低为 $0.01，提供基础指标
- 将竞争对手深度分析限制在前 3 名——控制成本
- 关键词差距分析是最具可操作性的输出——始终包含它
错误处理
NO_CREDITS(402) — 告知用户前往 https://yepapi.com/dashboard 添加积分UPSTREAM_ERROR(502) — 重试一次；如果再次失败，则跳过该步骤并记录VALIDATION_ERROR(400) — 检查域名格式；使用不带协议的裸域名RATE_LIMITED(429) — 等待后重试；遵守Retry-After响应头