> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Google 検索結果 API (GOOGLE_SERP)

> クエリに対する google.com の自然検索結果、広告、SERPパネルを1ページ分取得します。AIによる概要を待ちません。

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

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

## リクエスト

```bash theme={"theme":"css-variables"}
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 } }'
```

タスクは非同期で実行されます。結果は[非同期タスク](/ja/concepts/async-tasks.md)の説明に従って読んでください。

## パラメータ

| フィールド | 必須 | 説明 |
| - | - | - |
| `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ページ目です。

```json theme={"theme":"css-variables"}
{
  "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`](/ja/engines/google-ai-overviews) を使ってください。

## 制限とエラー

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

## 関連

* [Google AI による概要](/ja/engines/google-ai-overviews.md): 同じページをAIによる概要付きで
* [Webスクレイプ](/ja/engines/web-scrape.md): 結果のページをMarkdownで読む
* [地域と位置](/ja/engines/capacity.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.