キーワードリサーチワークフロー
専用のキーワードリサーチワークフロー — 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 | 2 つのドメイン間のキーワードギャップ分析 |
ワークフロー
ステップ 1: キーワードアイデアを生成する
シードキーワードから始めます。POST /v1/seo/keywords/ideas を実行します。
{
"keyword": "project management",
"location": "us"
}
戻り値: シードに基づくキーワード提案 — コンテンツアングルとロングテールバリエーション。
ステップ 2: 関連キーワードを見つける
POST /v1/seo/keywords/related で拡張します。
{
"keyword": "project management",
"location": "us"
}
戻り値: 意味的に関連する用語 — 広義および狭義のバリエーション。
ステップ 3: キーワードメトリクスを評価する
すべての候補キーワードを指定して POST /v1/seo/keywords を実行します。
{
"keywords": ["project management software", "project management tools", "best project management app"],
"location": "us"
}
戻り値: 検索ボリューム、CPC、キーワード難易度、検索意図(情報/商業/取引)、12 か月のトレンド。
ステップ 4: キーワードギャップ分析(オプション)
ユーザーが自社ドメインと競合ドメインを持っている場合、POST /v1/seo/keyword-gap を実行します。
{
"domain": "example.com",
"competitor": "competitor.com"
}
戻り値: 競合がランクインしているが自社はランクインしていないキーワード — 未開拓の機会。
ステップ 5: キーワードを優先順位付けする
機会スコアで並べ替えた優先キーワードリストを提示します:
- 高機会 — 高ボリューム + 低難易度
- 意図ごとにグループ化 — 情報、ナビゲーション、商業、取引
- 季節性キーワードにフラグを付ける — トレンドデータから 12 か月のパターンを確認
ルール
- アイデアで広く始め、次にメトリクスで絞り込む
- キーワードを検索意図でグループ化する: 情報、ナビゲーション、商業、取引
- トレンドデータを使用して季節性キーワードにフラグを付ける(12 か月のパターン)
- キーワードメトリクス呼び出しはバッチ処理する — 1 リクエストあたり最大 100 キーワード($0.15)は個別ルックアップよりも安価
エラーハンドリング
NO_CREDITS(402) — ユーザーに https://yepapi.com/dashboard でクレジットを追加するように伝えるUPSTREAM_ERROR(502) — 1 回再試行する; それでも失敗した場合はそのステップをスキップして記録するVALIDATION_ERROR(400) — キーワード形式を確認する; キーワードは空でない文字列である必要があるRATE_LIMITED(429) — 待機して再試行する;Retry-Afterヘッダーに従う