seo/
related-keywords

関連検索のつながりをたどって1つのシードに関連するクエリを見つけ、キーワード指標、月別の需要、検索意図、関連の深さを正規化されたレコードで返します。

Related Keywords API

関連検索のグラフ
深さの制御
キーワードの計測値
結果1件あたり0.1クレジット
準備完了
README

SocQ 編集 · 更新

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つのシードクエリを送信し、完了した非同期タスクから関連レコードを読み取ります。

  1. 空でない query を1つ選び、location_code、language_code、0〜4の depth、1〜1,000の results_limit、0以上の offset を指定します。
  2. ペイロードを /v1/seo/related-keywords に POST し、返された task_id を保存します。
  3. タスクが成功するか失敗を返すまで /v1/tasks/{task_id} をポーリングします。
  4. 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 true

Related 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 フィールドが欠落する可能性を考慮してください。

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 — 送信したキーワード群の主な検索意図と副次的な検索意図を分類し、元の確率とレコード全体をそのまま保持します。

他のプラットフォームを見る

SEOのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

Related Keywords API — よくある質問

Related Keywords APIは、選択した検索市場の関連検索グラフを通じて、1つのシードとつながるクエリを見つけるためのプログラムインターフェースです。キーワード、取得可能な計測値、月別の推移、検索意図の情報、関連の深さ、ソースの行全体を返します。

depth には0〜4を指定できます。0は送信したシード、1は直接の関連を表し、それより大きい値では再帰的に展開されます。深さを大きくすると、候補の範囲が広がり、関連性がより間接的になることがあります。

いいえ。関連検索のつながりでは異なる言い回しが返されることがあります。フレーズを含むロングテールのバリエーションが必要な場合は Keyword Suggestions を使用してください。

正規化されたレコードには、キーワード、検索ボリューム、CPC、広告の競合性、キーワード難易度、月別の検索数、検索意図の情報が含まれる場合があります。ソースの関連の深さ、関連の経路、keyword_data オブジェクト全体は extra に保持されます。

results_limit は1〜1,000の上限値で、offset はスキップする先頭側のソース行の数です。offset はページ番号ではありません。また、ソースから返される行数がリクエストより少ない場合もあります。

返された関連キーワード1件につき0.1 SocQクレジットです。結果が空の場合は結果に対する課金は発生しません。results_limit はリクエスト前の見積もりに使われるもので、最終的な件数を保証するものではありません。