seo/
keywords-for-site

1つのWebサイトのドメインに関連するキーワード案を生成し、検索ボリューム、CPC、広告の競合性、月別検索数、詳細なコンテキストを正規化されたレコードで返します。

Keywords for Site API

ドメインとの関連性
キーワードの需要指標
正規化されたキーワードレコード
結果1件あたり0.1クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Keywords for Site

サイト関連キーワードのレコードは、Webサイトのトピックと、関連する検索語、検索ボリューム、CPC、広告の競合性、月別の需要、カテゴリ情報を結びつけます。これらのキーワードと指標の関係は、トピックの発見、競合調査、候補リストの作成、ドメイン間の比較に活用できます。

Keywords for Site API の主な機能

  • ドメインに基づく関連キーワードの発見シードフレーズから始めるのではなく、1つのWebサイトのドメインを使って、そのトピックに関連するキーワード案を取得します。
  • 需要と検索広告の指標返された各キーワードを、正規化された検索ボリューム、CPC、広告の競合性、競合性レベル、月別の検索数で評価できます。
  • キーワードの詳細なコンテキスト返された行全体は extra で確認できます。任意のカテゴリ、難易度、検索意図、トレンドのフィールドなど、正規化されていない属性も参照できます。

Keywords for Site API のパラメータ

パラメータ必須説明
target必須必須。トピックの取得元となるWebサイトのドメインです。Playgroundの既定値は microsoft.com です。
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の範囲で指定します。Playgroundではドキュメントの例にあわせて5を送信します。省略した場合、バックエンドは100を使用します。

Keywords for Site API の使い方

市場、言語、結果の上限数を設定して1つのドメインを送信し、完了したタスクから正規化されたキーワードレコードを読み取ります。

  1. 対象ドメインを1つ選び、正の location_code、language_code、1〜1,000の results_limit を指定します。
  2. ペイロードを /v1/seo/keywords-for-site に 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/keywords-for-site" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target":"microsoft.com","location_code":2840,"language_code":"en","results_limit":5}'

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

Keywords for Site API の主なユースケース

  • Webサイトのトピック発見: 返されたキーワードとカテゴリを使い、既知のWebサイトに関連する検索テーマを特定します。
  • 競合サイトのキーワード調査: 競合のドメインを送信し、関連キーワードを検索ボリューム、CPC、広告の競合性と組み合わせて調査用のセットを作成します。
  • ドメイン間のトピック比較: Webサイトごとに個別に実行し、返されたキーワードセット、カテゴリ、需要指標を比較します。

Keywords for Site API 活用のヒント

  • target の形式が無効にならないよう、ドメインを送信する前に http:// や https:// を取り除いてください。
  • 実行結果を比較する場合は、省略時のプロバイダーの挙動に頼らず、市場と言語を明示的に指定してください。
  • このエンドポイントには後続の結果範囲を取得する offset がないため、results_limit は1回で必要な最大の件数に設定してください。
  • 欠落している指標は0ではなくデータなしとして扱い、必要な属性が正規化フィールドにない場合は extra を確認してください。
  • 関連性に基づくキーワード案ではなく、実際の掲載順位や上位表示されているURLが必要な場合は、Ranked Keywords を使用してください。

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

  • Google Organic SERP API — クエリと市場を指定して、Googleの検索結果ページ1件をリアルタイムで取得し、正規化された遷移先、順位、要素タイプ、結果の詳細一式を返します。
  • Keyword Difficulty API — 送信したキーワード群のオーガニック検索での上位表示の難しさを比較し、取得できた各キーワードを正規化されたスコアとともに返します。
  • Keyword Overview API — 送信したキーワード群に、取得可能な需要、広告の競合度、難易度、月間検索数、検索意図の情報を付加します。
  • Keyword Search Volume API — 既知のキーワードについて、取得可能な検索ボリューム、CPC、広告の競合度、月間検索数の推移を計測します。
  • Ranked Keywords API — ドメイン、サブドメイン、ページがランクインしているキーワードを、一致するURL、順位、検索指標、検索意図、元データの全要素とともに取得します。
  • Relevant Pages API — 1つのドメインのインデックス済みページを一覧化し、オーガニック検索と広告の順位分布、推計トラフィック、推定コストの情報を返します。

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

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

Keywords for Site API — よくある質問

Keywords for Site APIは、1つのWebサイトのドメインからキーワード案を生成するためのプログラムインターフェースです。検索ボリューム、CPC、広告の競合性、月別検索数、返されたコンテキスト全体を含む正規化されたキーワードを返しますが、関連性があることは検索順位があることを意味しません。

http:// や https:// を付けずに、example.com のようなドメインを1つ送信してください。1つのタスクで指定できるWebサイトは1つです。

返されません。返されるキーワードは関連性に基づく候補であり、そのWebサイトが実際に上位表示されていることを示すものではありません。掲載順位と一致するURLが必要な場合は Ranked Keywords を使用してください。

できません。results_limit には1〜1,000を指定でき、1つのタスクで取得する最大行数を設定しますが、公開されている入力には後続の結果範囲を取得するための offset がありません。

返されたキーワード1件につき0.1 SocQクレジットです。返された行がないタスクには結果に対する課金は発生しません。