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要素を読み取ります。
- 空でない query を1つ選び、location_code、language_code、device、1〜200の results_limit を指定します。
- ペイロードを /v1/seo/google-organic-serp に POST し、返された task_id を保存します。
- タスクが成功するか失敗を返すまで /v1/tasks/{task_id} をポーリングします。
- 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 trueGoogle 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要素タイプによって異なり、今後変わる可能性もあるため、柔軟なオブジェクトとして保存してください。
関連API
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ニュースの記事を、トップニュースを先頭に、見出し、媒体名、記事への直リンク、抜粋、公開日時とともに集めます。
- Keywords for Site API
- Keyword Suggestions API
- Ranked Keywords API
- Relevant Pages API
- Backlinks Summary API
- Backlinks API
- Referring Domains API
- Backlink Competitors API
- Domain Overview API
- Competitor Domains API
- Traffic Estimate API
- Domain Technologies API
- Whois Lookup API
- Google Images API
- Bing Search API
- YouTube Rank Tracker API
- Google Autocomplete API