seo/
keyword-overview

1つの市場で最大1,000件の既知のキーワードに、取得可能な検索ボリューム、CPC、広告の競合性、キーワード難易度、月別トレンド、検索意図を付与し、正規化されたレコードで返します。

Keyword Overview API

キーワード指標をまとめて取得
最大1,000キーワード
需要と競合性の指標
1キーワードあたり0.15クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Keyword Overview

キーワード概要レコードは、既知の検索語について、検索需要、広告の競合性、オーガニック検索の難易度、月別の観測値、分類された検索意図をまとめたものです。これらの補完し合う指標は、キーワードリストの情報補完、機会の比較、調査対象の分類、時系列を考慮した需要分析に活用できます。

Keyword Overview API の主な機能

  • 既知キーワードの一括入力用意したキーワード1〜1,000件を、選択した1つの検索市場と言語の設定で評価します。
  • 需要と検索広告のフィールド取得可能な検索ボリューム、CPC、競合性、競合性レベル、競合性インデックス、月別の観測値を保持し、需要と広告市場の比較に利用できます。
  • オーガニック難易度と検索意図取得可能なキーワード難易度と検索意図の情報を需要フィールドとあわせて含めるため、異なる指標を同じキーワードに紐づけたまま扱えます。
  • 概要データの行全体keyword_info、keyword_properties、検索結果のメタデータなど、返されたその他のオブジェクトが存在する場合は extra に保持します。

Keyword Overview 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 Overview API の使い方

コード形式の市場設定とともに件数の上限内で既知のキーワードリストを送信し、非同期の結果レコードから正規化フィールドと概要オブジェクト全体を読み取ります。

  1. 空でない既知のキーワードを1〜1,000件用意します。各キーワードは80文字以内にしてください。
  2. keywords を location_code、language_code とともに /v1/seo/keyword-overview に POST し、返された task_id を保存します。
  3. タスクが成功するか失敗を返すまで /v1/tasks/{task_id} をポーリングします。
  4. data.results.items を読み取り、正規化されていないソースフィールドは extra.keyword_info または extra.keyword_properties で確認します。has_more が true の間は next_cursor をたどって続きを取得します。
curl -X POST "https://api.socq.ai/v1/seo/keyword-overview" \
  -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 Overview API の主なユースケース

  • キーワードリストの情報補完: 返された keyword_info と keyword_properties のフィールドを用意したキーワードリストに結合し、共通の調査レコードを作成します。
  • 需要と競合性の比較: 検索広告とオーガニック検索の指標を同一視せずに、検索ボリューム、CPC、広告の競合性、キーワード難易度を比較します。
  • 検索意図とトレンドによる分類: 検索意図の情報と月別の検索数を組み合わせ、既知のキーワードを想定される目的と需要のパターンごとに整理します。

Keyword Overview API 活用のヒント

  • 課金は入力件数に基づいて計算されるため、送信前にキーワードの重複を排除してください。
  • キーワードを比較する場合は、選択した検索環境が一貫するよう location_code と language_code を固定してください。
  • このバッチは keywords 配列で制御され、概要の取得処理には結果件数を制御する仕様が文書化されていないため、results_limit は省略してください。
  • ソースの値がすべて正規化されたトップレベルのフィールドに反映されるわけではないため、概要の全体は extra.keyword_info と extra.keyword_properties で確認してください。
  • 欠落しているフィールドは数値の0ではなくデータなしとして扱い、返されたレコードは配列の位置ではなくキーワードで照合してください。
  • CPC と競合性は検索広告の指標として解釈し、keyword_difficulty はオーガニック検索における推定の競合度として扱ってください。

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

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

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

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

Keyword Overview API — よくある質問

Keyword Overview APIは、1つの検索市場で1〜1,000件の既知のキーワードに情報を付与するためのプログラムインターフェースです。データのある各キーワードについて、取得可能な需要、広告の競合性、オーガニック検索の難易度、月別検索数、検索意図、ソースの行全体のフィールドを返します。

バッチは必須の keywords 配列で定義され、各80文字以内の空でない文字列を1〜1,000件指定します。Playgroundで使用する検索環境は location_code と language_code で選択します。

まず正規化された metrics、monthly_searches、search_intent を読み取り、正規化されていないソースフィールドは extra.keyword_info と extra.keyword_properties で確認してください。extra 内のキーは任意で、柔軟に変わる可能性があります。

いいえ。CPC と競合性は検索広告の指標を表し、keyword_difficulty はオーガニック検索での上位表示の競合度を推定したものです。それぞれのフィールドは個別の比較に使用してください。

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