競合調査ワークフロー
YepAPI エンドポイントを使用したドメイン間の競合分析。
使用するエンドポイント
| エンドポイント | コスト | 目的 |
|---|---|---|
POST /v1/seo/domain/overview | $0.01 | トラフィック、キーワード、バックリンク、ドメインランク |
POST /v1/seo/competitors | $0.04 | キーワードの重複に基づく SEO 競合ドメイン |
POST /v1/seo/keyword-gap | $0.04 | 2つのドメイン間のキーワードギャップ分析 |
ワークフロー
ステップ 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) — 1回再試行。再び失敗した場合はそのステップをスキップし、その旨を記載するVALIDATION_ERROR(400) — ドメイン形式を確認。プロトコルなしのベアドメインを使用RATE_LIMITED(429) — 待機して再試行。Retry-Afterヘッダーを尊重