seo/
google-organic-serp

1つの検索クエリと市場を指定してGoogleの検索結果ページをリアルタイムに取得し、遷移先URL、タイトル、掲載順位、要素タイプ、結果の詳細を正規化されたレコードで返します。

Google Organic SERP API

リアルタイムのSERPスナップショット
デバイスの選択
多様な検索結果要素
結果1件あたり0.1クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Google Organic SERP

Googleのオーガニック検索結果ページには、順位付けされたリンクに加えて、強調スニペット、関連する質問、ローカル検索結果、動画などの要素が表示されます。これらの遷移先、掲載順位、要素タイプ、表示内容の詳細は、順位のスナップショット取得、SERPレイアウトの分析、デバイス別・市場別の比較に活用できます。

Google Organic SERP API の主な機能

  • 1クエリ単位の市場別スナップショット1つの検索クエリを、明示した市場、言語、デスクトップまたはモバイルの設定で照会し、比較可能な特定時点の検索結果ページを取得します。
  • 順位と遷移先のフィールド取得できる遷移先URL、表示タイトル、グループ内順位、全体順位、検索結果のページ番号を正規化されたフィールドで返します。
  • 多様なSERP要素に対応オーガニックリンクとその他の結果タイプをそのまま保持し、extra.type で各レコードが表す要素の種類を識別できます。
  • 要素ごとの詳細情報要素固有のオブジェクト全体を extra に保持するため、ドメイン、スニペット、パンくずリスト、画像、リッチリザルトの属性が存在する場合はそのまま利用できます。

Google Organic SERP API のパラメータ

パラメータ必須説明
query必須必須。空でない検索クエリです。1つのタスクで指定できるクエリは1つです。
location_code任意正の数値で指定する市場コードです。Playgroundの既定値は米国を表す2840です。
location_name任意任意。location_code の代わりに使える検索市場名です。指定した場合は location_code より優先されます。
language_code任意2〜10文字の検索言語コードです。Playgroundの既定値は en です。
language任意任意。language_code の代わりに使える検索言語名です。指定した場合は language_code より優先されます。
device任意検索時のデバイス環境です。desktop または mobile を指定します。
results_limit任意取得する順位の深さで、1〜700の範囲で指定します。上限値であり、展開後の要素数が同じ数になることは保証されません。

Google Organic SERP API の使い方

コード形式の市場設定と取得深度の上限を指定して1つのクエリを送信し、完了した非同期タスクから正規化されたSERP要素を読み取ります。

  1. 空でない query を1つ選び、location_code、language_code、device、1〜200の results_limit を指定します。
  2. ペイロードを /v1/seo/google-organic-serp に 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/google-organic-serp" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"keyword research","location_code":2840,"language_code":"en","device":"desktop","results_limit":10}'

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

Google Organic SERP API の主なユースケース

  • 現在の順位のスナップショット: 遷移先URLと rank.group、rank.absolute、rank.page、collected_at を組み合わせ、特定のクエリで各ページがどこに表示されたかを記録します。
  • デバイス・市場別の比較: device、location_code、language_code の値を管理しながら同じクエリを送信し、条件ごとの遷移先と掲載順位を比較します。
  • SERPレイアウトの分析: extra.type と要素固有のフィールドを確認し、順位付けされたリンクと、関連する質問、スニペット、ローカル検索結果、動画などの検索結果機能を区別します。

Google Organic SERP API 活用のヒント

  • デスクトップとモバイルを比較する場合は、query、location_code、language_code を変えず、デバイスだけを変数にしてください。
  • ルートの検証ではより大きな値も受け付けますが、リアルタイムの詳細結果の取得深度は200が上限のため、results_limit は200以下にしてください。
  • 要素固有のキーを読み取る前に extra.type で処理を分岐し、url や順位の値を持たない要素ではそれらが欠落することを想定してください。
  • rank.page は検索結果のページ番号として扱い、保存されたSocQの結果レコードのページネーションには別途 next_cursor を使用してください。
  • extra で取得できるキーはSERP要素タイプによって異なり、今後変わる可能性もあるため、柔軟なオブジェクトとして保存してください。

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

  • Keyword Difficulty API — 送信したキーワード群のオーガニック検索での上位表示の難しさを比較し、取得できた各キーワードを正規化されたスコアとともに返します。
  • Keyword Overview API — 送信したキーワード群に、取得可能な需要、広告の競合度、難易度、月間検索数、検索意図の情報を付加します。
  • Keyword Search Volume API — 既知のキーワードについて、取得可能な検索ボリューム、CPC、広告の競合度、月間検索数の推移を計測します。
  • Related Keywords API — 1つのシードクエリから関連検索をたどり、深さを指定して、取得可能なキーワード指標、検索意図の情報、元データの全行を返します。
  • Search Intent API — 送信したキーワード群の主な検索意図と副次的な検索意図を分類し、元の確率とレコード全体をそのまま保持します。
  • Google News API — 検索語に対するGoogleニュースの記事を、トップニュースを先頭に、見出し、媒体名、記事への直リンク、抜粋、公開日時とともに集めます。

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

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

Google Organic SERP API — よくある質問

Google Organic SERP APIは、クエリ、市場コード、言語コード、デバイスを指定して、Googleの検索結果ページを1件リアルタイムに取得するためのプログラムインターフェースです。正規化された遷移先、タイトル、掲載順位、要素タイプ、要素固有の詳細情報をすべて返します。

Playgroundでは、必須の query に加えて location_code、language_code、device、results_limit を指定できます。名前で指定する代替パラメータとの組み合わせによる曖昧さを避けるため、市場と言語はコードで選択します。

いいえ。リアルタイムの詳細結果ページには、オーガニックリンク、強調スニペット、関連する質問、ローカル検索結果、動画など、表示されるさまざまな要素が含まれます。各レコードの extra.type を確認してください。

はい。検索結果ページの要素の中には、遷移先URLやすべての順位の値を持たないものがあります。クライアント側では url、rank.group、rank.absolute、rank.page を null になり得る値として扱ってください。

返された正規化SERP要素1件につき0.1 SocQクレジットです。結果が空の場合は結果に対する課金は発生しません。リクエストで指定する深さは見積もりであり、返される件数を保証するものではありません。