Related Keywords
関連キーワードとは、「他の人はこちらも検索」のような関連検索のグラフでつながったクエリで、深さ、需要、CPC、競合性、難易度、検索意図の指標を伴います。これらの関連性と計測値は、隣接するトピックの発見、トピックマップの拡張、候補の比較に活用できます。
Related Keywords API の主な機能
- 関連検索グラフの展開フレーズを含むことを条件とせず、1つのシードから0〜4の深さで直接的または再帰的なクエリの関連をたどります。
- キーワードの計測オブジェクト関連する各クエリについて、取得可能な検索ボリューム、CPC、広告の競合性、月別の推移、難易度、検索意図の情報を返します。
- 関連性のコンテキストを保持ソースの深さ、関連キーワードの経路、keyword_data 全体、その他の可変フィールドを extra に保持し、グラフを詳しく解釈できるようにします。
Related Keywords API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
query | 必須 | 必須。空でないシードキーワードまたはフレーズです。1つのタスクで指定できるクエリは1つです。 |
location_code | 任意 | 任意。正の数値で指定する検索市場コードです。 |
location_name | 任意 | 任意。location_code の代わりに使える検索市場名です。指定した場合は location_code より優先されます。 |
language_code | 任意 | 任意。2〜10文字の検索言語コードです。 |
language | 任意 | 任意。language_code の代わりに使える検索言語名です。指定した場合は language_code より優先されます。 |
depth | 任意 | 0〜4の範囲で指定する関連の深さです。既定値の1では、直接つながっているクエリを返します。 |
results_limit | 任意 | 取得する関連キーワードの上限数で、1〜1,000の範囲で指定します。返される行数がこれより少ない場合があります。 |
offset | 任意 | 指定した取得範囲を収集する前にスキップするソース行の数です。0から数えます。 |
Related Keywords API の使い方
関連の深さ、市場の設定、結果の取得範囲とともに1つのシードクエリを送信し、完了した非同期タスクから関連レコードを読み取ります。
- 空でない query を1つ選び、location_code、language_code、0〜4の depth、1〜1,000の results_limit、0以上の offset を指定します。
- ペイロードを /v1/seo/related-keywords に POST し、返された task_id を保存します。
- タスクが成功するか失敗を返すまで /v1/tasks/{task_id} をポーリングします。
- data.results.items を読み取り、has_more が true の間は返された next_cursor を指定して続きをリクエストします。
curl -X POST "https://api.socq.ai/v1/seo/related-keywords" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"keyword research","depth":1,"results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueRelated Keywords API の主なユースケース
- 隣接トピックの発見: 返されたクエリと関連性のコンテキストを使い、シードフレーズを含まなくてもつながりのあるトピックを見つけます。
- トピックマップの拡張: 深さと関連キーワードの経路を比較し、1つのシードを直接の隣接クエリからより広いクエリグラフへと広げます。
- キーワード候補の評価: 関連キーワードを、取得可能な需要、コスト、競合性、難易度、月別の推移、検索意図と組み合わせ、検討用の候補セットを用意します。
Related Keywords API 活用のヒント
- 直接の関連を取得するには depth 1から始めてください。候補が増え、関連が間接的になる可能性があっても、より広いグラフが必要な場合にのみ depth を上げてください。
- 関連クエリは異なる言い回しになることがあるため、返されるすべての語にシードの単語を含める必要がある場合は Keyword Suggestions を使用してください。
- 結果の取得範囲を比較する場合は、関連性と市場のコンテキストを比較可能に保つため、query、location_code、language_code、depth を固定してください。
- offset はページ番号ではなく行数として扱い、スキップしたいソース行の数だけ増やしてください。
- まず正規化フィールドから keyword、metrics、monthly_searches、search_intent を読み取り、ソースの深さと関連の経路は extra で確認してください。
- グラフ上で近いことから検索意図が同じだと推測せず、任意の計測値や可変の extra フィールドが欠落する可能性を考慮してください。
関連API
Related Keywords API 以外に別の種類の公開SEOデータが必要な場合は、これらのAPIをご利用ください。
- Google Organic SERP API — クエリと市場を指定して、Googleの検索結果ページ1件をリアルタイムで取得し、正規化された遷移先、順位、要素タイプ、結果の詳細一式を返します。
- Keyword Difficulty API — 送信したキーワード群のオーガニック検索での上位表示の難しさを比較し、取得できた各キーワードを正規化されたスコアとともに返します。
- Keyword Overview API — 送信したキーワード群に、取得可能な需要、広告の競合度、難易度、月間検索数、検索意図の情報を付加します。
- Keyword Search Volume API — 既知のキーワードについて、取得可能な検索ボリューム、CPC、広告の競合度、月間検索数の推移を計測します。
- Keyword Suggestions API — 1つのシードクエリを、一致するロングテールキーワードに展開し、取得可能な需要指標、月次推移、検索意図の情報、元データの全行を返します。
- Search Intent API — 送信したキーワード群の主な検索意図と副次的な検索意図を分類し、元の確率とレコード全体をそのまま保持します。
- Keywords for Site API
- Ranked Keywords API
- Relevant Pages API
- Backlinks Summary API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Domain Overview API
- Competitor Domains API
- Traffic Estimate API
- Domain Technologies API
- Whois Lookup API
- Google News API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API