Google 検索結果 API (GOOGLE_SERP) - querying.ai

GOOGLE_SERP は google.com の結果ページを1つ読み込み、自然検索結果とパネルを返します。AIによる概要を待たないため、GOOGLE より速く、料金も低くなります。順位トラッキングや、WEB_SCRAPE で読むページ探しに使ってください。


`taskType`	`GOOGLE_SERP`
入力	`query`(必須)、`page`、`country`、`location`、`include`
クレジット	タスクあたり1
国	既定値は `US`。任意の ISO 3166-1 alpha-2 コード。
位置	対応。地域と位置を参照してください。

リクエスト

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "GOOGLE_SERP", "payload": { "query": "best running shoes for flat feet", "country": "US", "page": 2 } }'

タスクは非同期で実行されます。結果は非同期タスクの説明に従って読んでください。

パラメータ

フィールド	必須	説明
`query`	はい	検索クエリ、1〜100,000文字。`query` がなければ `prompt` を受け付けます。
`page`	いいえ	結果ページ。1〜10の整数で、既定値は `1`。1ページに自然検索結果が10件入ります。それ以外の値は `422 VALIDATION_ERROR` を返します。
`country`	いいえ	検索する Google の市場。既定値は `US`。
`location`	いいえ	10進数の度で表した `{ "latitude", "longitude" }`。Google はその地点にいるユーザーへの結果を返し、結果の `location` に同じ地点が入ります。
`include.rawResponse`	いいえ	`true` で結果ページのHTMLを `rawContent` として追加します。ページは大きく、1MB近くになることもよくあります。

レスポンス

たとえば、あるクエリの2ページ目です。

{
  "organicResults": [
    { "position": 11, "title": "...", "link": "https://...", "displayedLink": "...", "snippet": "...", "page": 2 }
  ],
  "peopleAlsoAsk": [{ "...": "..." }],
  "relatedSearches": [{ "...": "..." }],
  "ads": [{ "...": "..." }],
  "page": 2
}

フィールド	説明
`organicResults`	常に存在します。`position` はページをまたいで数えるため、2ページ目の最初の結果は `11` です。各行に取得元の `page` が付きます。
`page`	読み込んだページ。
`peopleAlsoAsk`、`relatedSearches`、`knowledgeGraph`	ページに表示された場合の Google のパネル。
`ads`	ページに表示された場合の上部と下部の広告。
`map`	ローカルパック。ページに表示された場合、`name`、`position`、`placeId`、`location`、`mapsUrl`、`reviews` などを持つ場所が入ります。
`serp`	その他のパネル(存在する場合): `topStories`、`videoResults`、`localMap`、`discussionsAndForums`。
`location`	送った地点(送った場合)。
`rawContent`	結果ページのHTML。`include.rawResponse: true` のとき。

ページに表示されないパネルは、null や [] ではなく省略されます。organicResults と page 以外はすべて任意フィールドとして扱ってください。aioverview、text、sources はありません。AIによる概要には GOOGLE を使ってください。

制限とエラー

完了したタスクで organicResults が空なら、Google 自体がそのクエリに結果を返さなかったことを意味します。返す前に別のブラウザで再確認しています。
1〜10の範囲外の page は 422 VALIDATION_ERROR を返します。
不正な location は 400 VALIDATION_ERROR を返します。
その他のリクエストエラーはエラーに記載しています。

関連

Google AI による概要: 同じページをAIによる概要付きで
Webスクレイプ: 結果のページをMarkdownで読む
地域と位置