コンテンツリサーチワークフロー
YepAPI エンドポイントを使用した、トレンドとセンチメントデータによるコンテンツプランニング。
使用するエンドポイント
| エンドポイント | コスト | 目的 |
|---|---|---|
POST /v1/seo/trends | $0.02 | Google トレンドの経時的な興味度（最大5キーワード） |
POST /v1/seo/keywords/ideas | $0.03 | シードキーワードからのキーワード提案 |
POST /v1/seo/keywords | $0.15 | バルクキーワードメトリクス（ボリューム、CPC、難易度） |
POST /v1/seo/ai/chatgpt | $0.05 | クエリに対する ChatGPT の回答 |
POST /v1/seo/ai/gemini | $0.05 | クエリに対する Gemini の回答 |
ワークフロー
ステップ 1: トレンドを確認する
トピックに関するキーワードで POST /v1/seo/trends を実行します。
{
"keywords": ["コンテンツマーケティング", "AI コンテンツ", "SEO 戦略"]
}
戻り値：各キーワードの経時的な興味度 — 季節的なパターンや上昇中のトピックを特定します。
ステップ 2: コンテンツの切り口を発見する
シードキーワードで POST /v1/seo/keywords/ideas を実行します。
{
"keyword": "コンテンツマーケティング",
"location": "us"
}
戻り値：思いつかなかったかもしれないキーワードの提案 — それぞれがコンテンツの切り口の候補となります。
ステップ 3: キーワードを評価する
発見したキーワードに対して POST /v1/seo/keywords を実行します。
{
"keywords": ["コンテンツマーケティング戦略", "コンテンツマーケティング事例", "コンテンツマーケティング ROI"],
"location": "us"
}
戻り値：検索ボリューム、CPC、キーワード難易度、検索インテント、12ヶ月のトレンド。
ステップ 4: AI での可視性を確認する
POST /v1/seo/ai/chatgpt と POST /v1/seo/ai/gemini を実行して、トピックについて AI がどのように言及しているかを確認します。
{
"query": "最適なコンテンツマーケティング戦略"
}
戻り値：各 LLM が現在どのように回答しているか — トピックに関する AI の状況を把握するのに役立ちます。
ステップ 5: コンテンツブリーフを作成する
以下の情報をまとめてコンテンツブリーフを作成します。
- ターゲットキーワード — 最も機会が大きいもの（ボリューム対難易度）
- サポートキーワード — 含めるべき関連語句
- トレンドの方向性 — 上昇、安定、または下降
- AI の状況 — LLM が現在言及している内容、埋めるべきギャップ
ルール
- トレンドデータは季節パターンを示します — 今後のピークを確認してください
- AI 可視性チェックは、LLM が現在トピックについて何を言っているかを明らかにします（AI SEO に有用）
- キーワードアイデアは、考慮していなかったかもしれないコンテンツの切り口を提供します
- キーワードに取り組む前に、必ず難易度を確認してください — 新しいサイトでは DR 80 以上の用語は避けてください
エラーハンドリング
NO_CREDITS(402) — ユーザーに https://yepapi.com/dashboard でクレジットを追加するよう伝えてくださいUPSTREAM_ERROR(502) — 一度リトライします。それでも失敗した場合はそのステップをスキップし、その旨を記録しますVALIDATION_ERROR(400) — キーワードの形式を確認してください。キーワードは空でない文字列である必要がありますRATE_LIMITED(429) — 待機してリトライします。Retry-Afterヘッダに従ってください