seo/
keyword-suggestions

選択した検索市場で1つのシードクエリをロングテールキーワードに展開し、一致したキーワード、取得可能な需要指標、月別の推移、ソースの行全体を返します。

Keyword Suggestions API

シードフレーズとの一致
ロングテールキーワード
オフセットによる取得範囲
結果1件あたり0.1クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

Keyword Suggestions

キーワード候補とは、シードとなる単語やフレーズの前後や間に語句が加わったロングテールの検索語で、各レコードには需要、コスト、競合性、月別の推移、検索意図の指標が含まれる場合があります。これらの一致したキーワードと計測値は、検索クエリの拡張、コンテンツ企画のための調査、検索広告の分析、言い回しの違いを条件をそろえて比較する用途に活用できます。

Keyword Suggestions API の主な機能

  • 全文一致によるシードの展開送信したシードの単語を含み、フレーズの前後や間への語句の追加や語順の違いを許容した検索語を返します。
  • キーワードの計測オブジェクト取得可能な検索ボリューム、CPC、広告の競合性、月別の推移、難易度の詳細を、各レコードのソースデータ内に保持します。
  • 検索意図のコンテキスト一致した各キーワードについて、取得可能な主要・副次的な検索意図の情報を提供します。順位に関する推奨として扱うものではありません。
  • 取得範囲の制御1〜1,000の結果上限と、0から始まる行オフセットを受け付け、ソースの後続の範囲を取得できます。

Keyword Suggestions API のパラメータ

パラメータ必須説明
query必須必須。空でないシードキーワードまたはフレーズです。1つのタスクで指定できるクエリは1つです。
location_code任意正の数値で指定する検索市場コードです。Playgroundの既定値は2840です。
location_name任意任意。location_code の代わりに使える検索市場名です。指定した場合は location_code より優先されます。
language_code任意2〜10文字の検索言語コードです。Playgroundの既定値は en です。
language任意任意。language_code の代わりに使える検索言語名です。指定した場合は language_code より優先されます。
results_limit任意取得するキーワード候補の上限数で、1〜1,000の範囲で指定します。返される行数がこれより少ない場合があります。
offset任意指定した取得範囲を収集する前にスキップするソース行の数です。0から数えます。

Keyword Suggestions API の使い方

市場の設定と結果の取得範囲を指定して1つのシードクエリを送信し、完了した非同期タスクから各キーワード候補を読み取ります。

  1. 空でない query を1つ選び、location_code、language_code、1〜1,000の results_limit、0以上の offset を指定します。
  2. ペイロードを /v1/seo/keyword-suggestions に 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/keyword-suggestions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"keyword research","location_code":2840,"language_code":"en","results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Keyword Suggestions API の主なユースケース

  • ロングテールクエリの拡張: 1つのシードフレーズと返されたキーワードを使い、元の単語を含むより長いクエリのバリエーションを収集します。
  • コンテンツ企画の候補調査: 一致したキーワードを、取得可能な検索ボリューム、月別の推移、難易度、検索意図のフィールドと組み合わせ、検討用のキーワードセットを作成します。
  • 検索広告キーワードの比較: 候補をプランニングのワークフローに渡す前に、言い回しの異なるキーワード間で取得可能な CPC と広告の競合性の計測値を比較します。

Keyword Suggestions API 活用のヒント

  • 厳密に一致するロングテールのバリエーションが必要な場合は具体的なシードフレーズを使用してください。シードの単語を含む必要がない場合は、意味ベースのキーワードエンドポイントを選んでください。
  • offset はページ番号ではなく行数として扱い、スキップしたいソースの範囲のサイズ分だけ増やしてください。
  • 条件が同じリクエストでも後からソースの並び順が変わることがあるため、query、location_code、language_code、results_limit、offset をまとめて記録してください。
  • まず正規化フィールドから keyword と search_intent を読み取り、正規化されていない計測オブジェクトは extra.keyword_info と extra.keyword_properties で確認してください。
  • 重複して取得した範囲は、キーワードと市場・言語の組み合わせで重複排除し、任意の指標やネストされたオブジェクトはすべて欠落する可能性を考慮してください。

Keyword Suggestions API 以外に別の種類の公開SEOデータが必要な場合は、これらのAPIをご利用ください。

  • Google Organic SERP API — クエリと市場を指定して、Googleの検索結果ページ1件をリアルタイムで取得し、正規化された遷移先、順位、要素タイプ、結果の詳細一式を返します。
  • Keyword Difficulty API — 送信したキーワード群のオーガニック検索での上位表示の難しさを比較し、取得できた各キーワードを正規化されたスコアとともに返します。
  • Keyword Overview API — 送信したキーワード群に、取得可能な需要、広告の競合度、難易度、月間検索数、検索意図の情報を付加します。
  • Keyword Search Volume API — 既知のキーワードについて、取得可能な検索ボリューム、CPC、広告の競合度、月間検索数の推移を計測します。
  • Keywords for Site API — 1つのWebサイトに関連するキーワードを、取得可能な需要指標、月次推移、市場情報、元データの全行とともに生成します。
  • Related Keywords API — 1つのシードクエリから関連検索をたどり、深さを指定して、取得可能なキーワード指標、検索意図の情報、元データの全行を返します。

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

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

Keyword Suggestions API — よくある質問

Keyword Suggestions APIは、1つのシードクエリ、市場コード、言語コードからロングテールの検索語を見つけるためのプログラムインターフェースです。一致したキーワード、取得可能な需要と競合性の詳細、月別の推移、検索意図のコンテキスト、ソースの行全体を返します。

キーワード候補には送信したシードの単語が含まれ、その前後や間に語句が加わりますが、語順は異なる場合があります。このエンドポイントは、意味的に幅広い言い換えではなく、全文一致による展開に使用してください。

results_limit は1〜1,000の上限値で、offset はスキップする先頭側のソース行の数です。offset はページ番号ではなく、ソースの並び順は時間とともに変わることがあります。

安定したキーワードと取得可能な検索意図のフィールドは正規化されます。一方、検索の計測値やキーワードの属性は extra.keyword_info と extra.keyword_properties に残る場合があります。任意の値はすべて null になり得るものとして扱ってください。

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