seo/
keyword-search-volume

最大1,000件の既知のキーワードについて、1つの市場または全世界を対象に、取得可能な検索ボリューム、CPC、広告の競合性、月別の推移を正規化されたレコードで返します。

Keyword Search Volume API

既知キーワードの計測
最大1,000キーワード
月別の需要推移
1リクエストあたり24クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Keyword Search Volume

キーワードの検索ボリュームレコードは、既知の検索語に、選択した検索環境または全世界における推定需要、CPC、広告の競合性、月別の観測値を組み合わせたものです。これらの計測値は、需要の比較、季節性の確認、検索広告市場の調査、キーワードリストの情報補完に活用できます。

Keyword Search Volume API の主な機能

  • 既知キーワードの一括計測用意したキーワードを1回のリクエストで1〜1,000件計測できます。各入力は80文字までです。
  • 検索需要のフィールド計測データのある各キーワードについて、取得可能な search_volume の値と monthly_searches の観測値を返します。
  • 検索広告市場のコンテキスト取得可能な CPC、競合性、競合性レベル、競合性インデックス、任意の入札フィールドを、計測したキーワードに紐づけたまま保持します。
  • ソースデータ付きの正規化レコード安定した需要フィールドを metrics に整理しつつ、返された行全体を extra に保持するため、任意の市場情報や入札のメタデータも確認できます。

Keyword Search Volume API のパラメータ

パラメータ必須説明
keywords必須必須。空でない既知のキーワードを1〜1,000件含むリストです。各項目は最大80文字です。
location_code任意任意。正の数値で指定する検索市場コードです。Playgroundでは米国を表す2840を明示的に送信します。バックエンドの全世界スコープを使う場合は、language_code とともにこのフィールドを空にしてください。
location_name任意任意。location_code の代わりに使える検索市場名です。指定した場合は location_code より優先されます。
language_code任意任意。2〜10文字の検索言語コードです。Playgroundでは en を明示的に送信します。バックエンドの全世界スコープを使う場合は、location_code とともにこのフィールドを空にしてください。
language任意任意。language_code の代わりに使える検索言語名です。指定した場合は language_code より優先されます。
results_limit任意任意。1〜2,000の範囲で指定する結果の上限数です。

Keyword Search Volume API の使い方

任意の市場と言語の設定とともに件数の上限内で既知のキーワードリストを送信し、非同期の結果レコードから正規化された需要フィールドを読み取ります。

  1. 空でない既知のキーワードを1〜1,000件用意します。各キーワードは80文字以内にしてください。
  2. keywords を /v1/seo/keyword-search-volume に POST します。市場を指定して再現可能なリクエストにする場合は location_code と language_code を含め、返された task_id を保存します。
  3. タスクが成功するか失敗を返すまで /v1/tasks/{task_id} をポーリングします。
  4. data.results.items を読み取り、has_more が true の間は next_cursor をたどって続きを取得します。正規化されていないソースフィールドは extra で確認します。
curl -X POST "https://api.socq.ai/v1/seo/keyword-search-volume" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keywords":["keyword research","seo tools"],"location_code":2840,"language_code":"en"}'

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

Keyword Search Volume API の主なユースケース

  • 用意したリストの需要比較: search_volume の値を既知のキーワードリストに結合し、一貫した検索環境の中で推定需要を比較します。
  • 月別の季節性の確認: year、month、search_volume の観測値を使い、計測された需要の時間的な変化を確認します。
  • 検索広告の市場調査: 計測したキーワード間で、CPC、競合性、競合性インデックス、任意の入札情報を比較します。

Keyword Search Volume API 活用のヒント

  • 24クレジットの固定料金は返された行ごとではなくリクエストごとにかかるため、必要に応じて用意したキーワードを上限内のバッチにまとめてください。
  • バッチ同士を比較する場合は、location_code と language_code を明示し、変更しないでください。両方を省略するのは全世界スコープを意図する場合だけにしてください。
  • この処理のバッチは keywords 配列で制御され、件数を制御する仕様は文書化されていないため、results_limit は送信しないでください。
  • 返された行はキーワードで照合し、レコードの欠落や null のフィールドは需要が0と確定したものではなく、データなしとして扱ってください。
  • CPC と競合性はオーガニック検索の難易度ではなく検索広告の指標として解釈し、表記ゆれの近いキーワードが集計済みのボリュームを共有する場合があることも考慮してください。

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

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

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

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

Keyword Search Volume API — よくある質問

Keyword Search Volume APIは、選択した市場または全世界を対象に、1〜1,000件の既知のキーワードを計測するためのプログラムインターフェースです。データのある各キーワードについて、取得可能な検索ボリューム、CPC、広告の競合性、月別の推移、ソースの行全体のフィールドを返します。

必須の keywords 配列には、各80文字以内の空でない文字列を1〜1,000件指定できます。location_code と language_code は任意で、市場と言語を省略した場合、バックエンドは全世界スコープを使用します。

行の欠落や null のフィールドは計測データが得られなかったことを意味し、必ずしも需要が0であることを示すものではありません。また、表記ゆれの近いキーワード同士で、集計された検索ボリュームの値を共有することがあります。

いいえ。CPC、competition、competition_level、competition_index、入札フィールドは検索広告のコンテキストを表すもので、このエンドポイントではオーガニック検索のキーワード難易度は算出しません。

受け付けられるバッチの範囲内であれば、キーワード数や返された行数にかかわらず、リクエスト1回につき24 SocQクレジットの固定料金です。