seo/
search-intent

指定した最大1,000件のキーワードを検索意図で分類し、主要・副次的な検索意図のラベルと確率を正規化されたキーワードレコードで返します。

Search Intent API

キーワードの一括入力
4種類の検索意図ラベル
主要・副次的な検索意図
1キーワードあたり0.1クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Search Intent

検索意図は、クエリを informational(情報収集型)、navigational(案内型)、commercial(比較検討型)、transactional(取引型)のラベルで表し、主要・副次的な意図の確率もあわせて示します。これらの分類は、キーワード一覧へのラベル付け、複数の意図が混在するキーワードの確認、コンテンツ企画との整合、用意したキーワードリストを調査ワークフローへ振り分ける用途に活用できます。

Search Intent API の主な機能

  • 言語を考慮した一括分類指定した最大1,000件のキーワードを、選択した1つの言語で分類します。言語を指定しない場合は英語が使用されます。
  • 主要・副次的な検索意図の指標最も可能性の高い検索意図とその確率に加え、その他の可能性のある検索意図とそれぞれの確率を返します。
  • 正規化されたレコードと元データ正規化された keyword と search_intent のフィールドを読み取れるほか、keyword_intent と secondary_keyword_intents を extra に保持します。

Search Intent API のパラメータ

パラメータ必須説明
keywords必須必須。空でないキーワードを1〜1,000件含むリストです。各キーワードは80文字以内です。
location_code任意任意。正の数値で指定する検索市場のロケーションコードです。
location_name任意任意。location_code の代わりに使える検索市場名です。指定した場合は location_code より優先されます。
language_code任意任意。2〜10文字の検索言語コードです。Playgroundの既定値は en です。
language任意任意。language_code の代わりに使える検索言語名です。指定した場合は language_code より優先されます。
results_limit任意任意。1〜2,000の範囲で指定する結果の上限数です。

Search Intent API の使い方

任意の市場、言語、結果の上限数の設定とともにキーワードリストを送信し、完了した非同期タスクから正規化された検索意図レコードを読み取ります。

  1. 空でないキーワードを1〜1,000件用意します。各キーワードは80文字以内にしてください。
  2. keywords と、必要に応じて市場、言語、results_limit のフィールドを /v1/seo/search-intent に 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/search-intent" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keywords":["how to research keywords","buy seo software"],"language_code":"en"}'

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

Search Intent API の主なユースケース

  • キーワード一覧へのラベル付け: 各キーワードとその主要な検索意図を使い、用意したキーワード一覧に一貫した検索意図のラベルを付与します。
  • 複数の意図が混在するキーワードの確認: 主要・副次的なラベルとそれぞれの確率を比較し、複数の検索目的を表している可能性のあるキーワードを特定します。
  • 調査ワークフローへの振り分け: 指定したキーワードを informational、navigational、commercial、transactional の検索意図ごとにグループ化し、それぞれ別の調査ワークフローに振り分けます。

Search Intent API 活用のヒント

  • 入力件数に基づく課金が分類したいキーワードだけに反映されるよう、バッチを送信する前に空の項目と重複を取り除いてください。
  • バッチ同士を比較する場合は、市場と言語のフィールドを統一してください。
  • 複数の意図が混在するキーワードでは、主要なラベルを普遍的な事実として扱わず、副次的な検索意図の確率も確認してください。
  • 分類結果が欠落する可能性を考慮し、元の keyword_intent と secondary_keyword_intents オブジェクトを確認する際は extra を読み取ってください。

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

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

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

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

Search Intent API — よくある質問

Search Intent APIは、指定した最大1,000件のキーワードを、選択した言語で分類するためのプログラムインターフェースです。取得できた各キーワードについて、正規化された主要・副次的な検索意図のラベルと確率を返します。

informational(情報収集型)、navigational(案内型)、commercial(比較検討型)、transactional(取引型)の4種類です。

keywords を送信し、必要に応じて location_code または location_name を設定し、language_code または language を選択します。必要な場合は results_limit を1〜2,000の範囲で指定してください。

空でないキーワードを1〜1,000件送信できます。各キーワードの最大長は80文字です。

検索意図の分類における確信度を表すもので、購入確率やコンバージョン率ではありません。そのため、複数の意図が混在するキーワードには、意味のある副次的な分類が含まれることがあります。

いいえ。送信したキーワードの中には分類結果が得られないものもあります。返されたレコードはキーワードで照合し、行が欠落している場合にも対応できるようにしてください。

送信したキーワード1件につき0.1 SocQクレジットです。