seo/
keyword-difficulty

1つの市場で最大1,000件のキーワードについてオーガニック検索での上位表示の難しさを比較し、取得できた各キーワードと0〜100のスコアを正規化されたレコードで返します。

Keyword Difficulty API

最大1,000キーワード
0〜100の難易度スコア
市場別の比較
1キーワードあたり0.1クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Keyword Difficulty

キーワード難易度スコアは、検索語でオーガニック検索の上位に表示されるための相対的な競合の激しさを推定した値で、値が大きいほど難易度が高いことを示します。これらのキーワード単位の指標は、優先順位付け、調査グループの分類、用意したキーワードリスト内での比較に活用できます。

Keyword Difficulty API の主な機能

  • キーワードの一括入力1つのタスクで空でないキーワードを1〜1,000件評価でき、選択した市場と言語の設定をバッチ全体に適用します。
  • 正規化された難易度指標取得できた各キーワードを metrics.keyword_difficulty とともに返します。通常は0〜100のスケールで表され、そのまま比較できます。
  • ソースデータをすべて保持返された行全体を extra に保持するため、安定した正規化スキーマとしては扱わずに、追加のソースフィールドを確認できます。

Keyword Difficulty API のパラメータ

パラメータ必須説明
keywords必須必須。空でないキーワードを1〜1,000件含むリストです。各項目は最大80文字です。
location_code任意正の数値で指定する検索市場コードです。Playgroundの既定値は米国を表す2840です。
location_name任意任意。location_code の代わりに使える検索市場名です。指定した場合は location_code より優先されます。
language_code任意バッチ全体に適用する2〜10文字の検索言語コードです。Playgroundの既定値は en です。
language任意任意。language_code の代わりに使える検索言語名です。指定した場合は language_code より優先されます。
results_limit任意任意。1〜2,000の範囲で指定する結果の上限数です。

Keyword Difficulty API の使い方

コード形式の市場設定とともに件数の上限内でキーワードリストを送信し、完了した非同期タスクから取得できた正規化スコアを読み取ります。

  1. 空でないキーワードを1〜1,000件用意します。各キーワードは80文字以内にしてください。
  2. keywords を location_code、language_code とともに /v1/seo/keyword-difficulty に 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-difficulty" \
  -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 Difficulty API の主なユースケース

  • キーワードリストの優先順位付け: 用意したキーワード群で metrics.keyword_difficulty を比較し、コンテンツ制作や調査の振り分けに競合性の指標を加えます。
  • 難易度帯による分類: 返されたスコアを社内で定めた範囲ごとにグループ化し、難易度の低いキーワードと高いキーワードの調査キューを整理します。
  • 市場ごとの比較: location_code と language_code の値を管理しながら同じキーワードリストを実行し、検索環境ごとの推定難易度を比較します。

Keyword Difficulty API 活用のヒント

  • 入力件数に応じた課金が重複しないよう、送信前にキーワードの重複を排除してください。
  • 1つの調査セット内でスコアを比較する場合は、location_code と language_code を変更しないでください。
  • このバッチは返却件数の上限ではなく keywords 配列で制御されるため、results_limit は省略してください。
  • 取得できなかったキーワードは返却レコードから除外されることがあるため、配列の位置ではなくキーワードで結果を照合してください。
  • スコア帯を作成する際は、数値の0と keyword_difficulty の値がない状態を区別してください。

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

  • Google Organic SERP API — クエリと市場を指定して、Googleの検索結果ページ1件をリアルタイムで取得し、正規化された遷移先、順位、要素タイプ、結果の詳細一式を返します。
  • Keyword Overview API — 送信したキーワード群に、取得可能な需要、広告の競合度、難易度、月間検索数、検索意図の情報を付加します。
  • Keyword Search Volume API — 既知のキーワードについて、取得可能な検索ボリューム、CPC、広告の競合度、月間検索数の推移を計測します。
  • Keywords for Site API — 1つのWebサイトに関連するキーワードを、取得可能な需要指標、月次推移、市場情報、元データの全行とともに生成します。
  • Keyword Suggestions API — 1つのシードクエリを、一致するロングテールキーワードに展開し、取得可能な需要指標、月次推移、検索意図の情報、元データの全行を返します。
  • Search Intent API — 送信したキーワード群の主な検索意図と副次的な検索意図を分類し、元の確率とレコード全体をそのまま保持します。

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

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

Keyword Difficulty API — よくある質問

Keyword Difficulty APIは、1つの検索市場で送信した1〜1,000件のキーワードについて、オーガニック検索での上位表示の難しさを比較するためのプログラムインターフェースです。取得できた各キーワードについて、0〜100に正規化された難易度スコアとソースの行全体を返します。

1つのタスクで、空でないキーワード文字列を1〜1,000件指定できます。各キーワードは最大80文字です。バッチのサイズは keywords 配列で決まります。

必ずしも返されるとは限りません。スコアを算出できない場合、キーワードが結果から除外されたり、難易度指標が含まれなかったりすることがあります。入力1件につき必ず1行が返るとは想定しないでください。

できません。このスコアは選択した市場におけるオーガニック検索での上位表示の難しさを相対的に推定したもので、順位の確率、トラフィック予測、サイト固有の推奨を示すものではありません。

送信したキーワード1件につき0.1 SocQクレジットです。結果行が得られなかったキーワードも課金対象になります。そのため、2件のキーワードを指定したPlaygroundリクエストの見積もりは0.2クレジットです。