# ライブ Google オーガニック SERP 詳細版
**API:** Data API
**Endpoint:** `POST /v1/beta/dataforseo/serp/google/organic/live/advanced`
**Tags:** DataForSEO
Google でキーワードのランキング結果を同期的に返します。`keyword`、`type`、`se_domain`、`location_code`、`language_code`、`check_url`、`datetime`、`spell`、`refinement_chips`、`item_types`、`items_count`、`items` を返します。既定では `advanced` を選択します。ランキング一覧だけが必要な場合は `regular`、パーサーが何を捨てたかを確認したい場合のみ `html` を使用してください。DataForSEO のエンベロープに包まれます。データは `tasks[0].result`、結果は `tasks[0].status_code` に格納され、拒否されたリクエストでも HTTP 200 が返ります。
### 料金の参考情報
- 計測方法：報告されたレスポンスコスト。
- 参考リクエスト見積もり：0.0175 USD。
- 参照用の顧客乗数：1.0。確定済みの顧客金額に再適用しないでください。
参照用のメタデータのみであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。
## Base URL
- `https://openapi.felo.ai`
## Authentication
- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)
## Request body
Required: **no**
### application/json
Schema:
```json
{
"type": "array",
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"type": "object",
"properties": {
"keyword": {
"type": "string",
"description": "キーワード必須フィールドkeyword フィールドには最大 700 文字を指定できますすべての %## はデコードされます（また、文字「+」はスペース文字にデコードされます）keyword に「%」文字を使用する必要がある場合は、「%25」として指定してください；keyword に「+」文字を使用する必要がある場合は、「%2B」として指定してください；このフィールドに「allinanchor:」、「allintext:」、「allintitle:」、「allinurl:」、「cache:」、「define:」、「definition:」、「filetype:」、「id:」、「inanchor:」、「info:」、「intext:」、「intitle:」、「inurl:」、「link:」、「site:」などのパラメータが含まれる場合、タスクごとの料金は 5 倍になりますDataForSEO API における keyword および keywords フィールドのルールと制限については、こちらのヘルプセンター記事を参照してください"
},
"location_code": {
"type": [
"integer",
"null"
],
"description": "検索エンジンのロケーションコードlocation_name または location_coordinate を指定しない場合は必須フィールドこのフィールドを使用する場合、location_name または location_coordinate を指定する必要はありませんhttps://api.dataforseo.com/v3/serp/google/locations に個別にリクエストすると、検索エンジンで利用可能なロケーションとその location_code の一覧を取得できます例：2840"
},
"language_code": {
"type": [
"string",
"null"
],
"description": "検索エンジンの言語コードlanguage_name を指定する場合は任意フィールドこのフィールドを使用する場合、language_name を指定する必要はありませんhttps://api.dataforseo.com/v3/serp/google/languages に個別にリクエストすると、検索エンジンで利用可能な言語とその language_code の一覧を取得できます例：en"
},
"depth": {
"type": [
"integer",
"null"
],
"description": "解析の深さ任意フィールドSERP の結果数デフォルト値：10最大値：200アカウントは、最大 10 件の結果を含む SERP ごとに課金されます。深さを 10 より大きく設定すると、検索エンジンが 10 件を超える結果を返した場合に追加料金が発生することがあります。コストは料金ページで計算できます。"
},
"device": {
"type": [
"string",
"null"
],
"description": "デバイスの種類任意フィールド特定のデバイスの種類の結果を返します次のいずれかの値を指定できます：desktop、mobileデフォルト値：desktop"
},
"load_async_ai_overview": {
"type": [
"boolean",
"null"
],
"description": "AI 概要を非同期で読み込む任意フィールド非同期で読み込まれる場合でも、SERP で ai_overview 項目を取得するには true に設定します；false に設定すると、キャッシュからのみ ai_overview 項目を取得します；デフォルト値：false注意：このパラメータを使用すると $0.002 の追加料金がかかります；要素が存在しない場合、または \"asynchronous_ai_overview\": false が含まれる場合、追加料金はすべてアカウント残高に返金されます"
},
"location_name": {
"type": [
"string",
"null"
],
"description": "検索エンジンのロケーションの正式名称location_code または location_coordinate を指定しない場合は必須フィールドこのフィールドを使用する場合、location_code または location_coordinate を指定する必要はありませんhttps://api.dataforseo.com/v3/serp/google/locations に個別にリクエストすると、検索エンジンで利用可能なロケーションとその location_name の一覧を取得できます例：London,England,United Kingdom"
},
"language_name": {
"type": [
"string",
"null"
],
"description": "検索エンジンの言語の正式名称language_code を指定する場合は任意フィールドこのフィールドを使用する場合、language_code を指定する必要はありませんhttps://api.dataforseo.com/v3/serp/google/languages に個別にリクエストすると、検索エンジンで利用可能な言語とその language_name の一覧を取得できます例：English"
},
"os": {
"type": [
"string",
"null"
],
"description": "デバイスのオペレーティングシステム任意フィールドdevice フィールドに desktop を指定した場合は、次の値から選択します：windows、macosデフォルト値：windowsdevice フィールドに mobile を指定した場合は、次の値から選択します：android、iosデフォルト値：android"
},
"tag": {
"type": [
"string",
"null"
],
"description": "ユーザー定義のタスク識別子 任意フィールド 文字数制限は 255 です このパラメーターを使用してタスクを識別し、結果と照合できます 指定した tag の値はレスポンスの data オブジェクトに含まれます"
},
"stop_crawl_on_match": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"type": "object",
"properties": {
"match_value": {
"type": [
"string",
"null"
],
"description": "ターゲットのドメインまたはワイルドカード値\nstop_crawl_on_match を指定する場合は必須フィールドです。\nターゲットのドメインまたはワイルドカード値を指定します。\n注意: ドメイン名はリクエストプロトコルなしで指定する必要があります。\n例: dataforseo.com"
},
"match_type": {
"type": [
"string",
"null"
],
"description": "ターゲットのマッチタイプ\nstop_crawl_on_match を指定する場合は必須フィールドです。\nmatch_value のマッチタイプ\n可能な値: domain、with_subdomains、wildcard"
}
}
}
]
},
"description": "クロールを停止するターゲットの配列\n任意フィールド\n指定した場合、レスポンスには指定した match_value までの SERP 結果が含まれます。\nこの配列には最大 10 個のターゲット値を指定できます\n例:\n\"stop_crawl_on_match\":[{\"match_value\":\"dataforseo.com\",\"match_type\":\"with_subdomains\"}]\nこのパラメータの詳細については、ヘルプセンターをご覧ください - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api\nアカウントには、指定したターゲットを通じてクロールされた SERP ごとに課金されます"
},
"match_type": {
"type": [
"string",
"null"
],
"description": "ターゲット一致タイプstop_crawl_on_match を指定する場合は必須フィールドmatch_value の一致タイプ指定可能な値：domain – 特定のドメインまたはサブドメインwith_subdomains – メインドメインとサブドメインwildcard – ワイルドカードパターン"
},
"match_value": {
"type": [
"string",
"null"
],
"description": "ターゲットのドメイン、サブドメイン、またはワイルドカード値stop_crawl_on_match を指定する場合は必須フィールドターゲットのドメイン、サブドメイン、またはワイルドカード値を指定します；注意：ドメインまたはサブドメインはリクエストプロトコルを付けずに指定してください；例：\"match_value\": \"dataforseo.com\"、\"match_value\": \"/blog/post-*\""
},
"max_crawl_pages": {
"type": [
"integer",
"null"
],
"description": "ページクロール上限任意フィールドクロールする検索結果ページ数最大値：100注意：クロールしたページごとに課金されます（1 ページあたり 10 件のオーガニック結果）；料金の詳細は料金ページをご覧ください；注意#2：max_crawl_pages と depth パラメータは互いに補完し合います。詳細はヘルプセンターをご覧ください"
},
"search_param": {
"type": [
"string",
"null"
],
"description": "検索クエリの追加パラメータ任意フィールド使用可能なパラメータの一覧と詳細はこちら注意：次の検索エンジンパラメータはサポートされておらず、指定された場合は自動的に解除されます：lr、cr、as_qdr、as_sitesearch、as_occt、as_filetype。"
},
"remove_from_url": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "URL から特定のパラメータを削除任意フィールドこのフィールドを使用すると、結果の URL から削除するパラメータを最大 10 個指定できます例：\"remove_from_url\": [\"srsltid\"]注意：target フィールドを指定した場合、指定した URL パラメータは検索前に削除されます"
},
"people_also_ask_click_depth": {
"type": [
"integer",
"null"
],
"description": "対応する要素のクリック数任意フィールド追加の people_also_ask_element 項目を取得するには、people_also_ask 要素のクリック深度を指定します；注意：アカウントにはクリックごとに $0.00015 の追加料金が請求されます；要素が存在しない場合、または指定した回数より少ないクリックしか実行されなかった場合、追加料金はすべてアカウント残高に返金されます指定可能な値：1 から 4"
},
"group_organic_results": {
"type": [
"boolean",
"null"
],
"description": "関連結果を表示任意フィールドtrue に設定すると、レスポンスの related_result 要素は親のオーガニック結果のスニペットとして提供されます；false に設定すると、related_result 要素は独立したオーガニック結果として提供されます；デフォルト値：true"
},
"calculate_rectangles": {
"type": [
"boolean",
"null"
],
"description": "高度な結果の SERP 要素のピクセルランキングを計算任意フィールドピクセルランキングとは、結果スニペットと画面左上隅との距離です。ヘルプセンターで詳細を確認する>>デフォルトでは、このパラメータは false に設定されています；注意：このパラメータを使用すると $0.002 の追加料金がかかります"
},
"browser_screen_width": {
"type": [
"integer",
"null"
],
"description": "ブラウザースクリーンの幅任意フィールド特定のデバイスのピクセルランキングを計算するために、ブラウザースクリーンの幅をカスタマイズできます；指定可能な範囲：240-9999；デフォルトでは、このパラメータは次のように設定されています：デスクトップ 1920；Android のモバイル 360；iOS のモバイル 375；注意：このパラメータを使用するには、calculate_rectangles を true に設定します",
"format": "int64"
},
"browser_screen_height": {
"type": [
"integer",
"null"
],
"description": "ブラウザースクリーンの高さ任意フィールド特定のデバイスのピクセルランキングを計算するために、ブラウザースクリーンの高さをカスタマイズできます；指定可能な範囲：240-9999；デフォルトでは、このパラメータは次のように設定されています：デスクトップ 1080；Android のモバイル 640；iOS のモバイル 812；注意：このパラメータを使用するには、calculate_rectangles を true に設定します"
},
"browser_screen_resolution_ratio": {
"type": [
"integer",
"null"
],
"description": "ブラウザースクリーンの解像度比任意フィールド特定のデバイスのピクセルランキングを計算するために、ブラウザースクリーンの解像度比をカスタマイズできます；指定可能な範囲：0.5-3；デフォルトでは、このパラメータは次のように設定されています：デスクトップ 1；Android のモバイル 3；iOS のモバイル 3；注意：このパラメータを使用するには、calculate_rectangles を true に設定します"
},
"url": {
"type": [
"string",
"null"
],
"description": "検索クエリの直接 URL任意フィールド直接 URL を指定すると、必要なフィールドに振り分けられます。この方法は API にとって最も処理が難しく、URL に正確な言語とロケーションを指定する必要があることに注意してください。ほとんどの場合、この方法はお勧めしません。例：https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS注意：次の検索エンジンパラメータはサポートされておらず、指定された場合は自動的に解除されます：lr、cr、as_qdr、as_sitesearch、as_occt、as_filetype。"
},
"location_coordinate": {
"type": [
"string",
"null"
],
"description": "ロケーションの GPS 座標location_name または location_code を指定する場合は任意フィールドこのフィールドを使用する場合、location_name または location_code を指定する必要はありません location_coordinate パラメータは \"latitude,longitude,radius\" 形式で指定する必要があります \"latitude\" と \"longitude\" の小数点以下の最大桁数：7 \"radius\" の最小値：199 (mm) \"radius\" の最大値：199999 (mm) 例：53.476225,-2.243572,200"
},
"se_domain": {
"type": [
"string",
"null"
],
"description": "検索エンジンのドメイン任意フィールド指定したロケーションと言語に応じて、関連する検索エンジンのドメインが自動的に選択されますただし、このフィールドでカスタムの検索エンジンドメインを設定できます例：google.co.uk、google.com.au、google.de など"
},
"target": {
"type": [
"string",
"null"
],
"description": "結果を取得する対象のドメイン、サブドメイン、またはウェブページ任意フィールドドメインまたはサブドメインは https:// と www. を付けずに指定してくださいtarget 固有のタスクの結果には、url 文字列を含む SERP 要素のみが含まれることに注意してください。SERP で検索パターンを指定して結果を絞り込むには、ワイルドカード（「*」）文字を使用することもできます。例：example.com - https://example.com、https://www.example.com/、https://example.com/ などの URL を持つウェブサイトのホームページの結果を返します。example.com* - そのドメインのすべてのページを含む結果を返します。*example.com* - ドメイン全体のすべてのページとサブドメインを含む結果を返します。*example.com - サブドメインに関係なく、https://en.example.com などのホームページの結果を返します。example.com/example-page - 完全一致する URL の結果を返します。example.com/example-page* - 指定した文字列で始まるドメイン内のすべての URL の結果を返します"
},
"target_search_mode": {
"type": [
"string",
"null"
],
"description": "ターゲット一致モード任意フィールドこのパラメータを有効にするには、stop_crawl_on_match も有効にする必要がありますstop_crawl_on_match で複数のターゲットを指定した場合に、クロールをどのように停止するかを定義します指定可能な値：all、anyall – 指定したすべてのターゲットが見つかった場合にのみクロールを停止しますany – いずれか 1 つのターゲットが見つかった時点でクロールを停止しますデフォルト値：anyこのパラメータの詳細はヘルプセンターをご覧ください"
},
"find_targets_in": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "ターゲットを確認する SERP 要素の種類任意フィールドこのパラメータを有効にするには、stop_crawl_on_match も有効にする必要がありますターゲット一致の確認対象とする SERP 要素の種類を指定します指定しない場合は、url フィールドと domain フィールドを持つすべての第 1 レベル要素がターゲットの確認対象になります指定可能な値：organic、paid、local_pack、featured_snippet、events、google_flights、images、jobs、knowledge_graph、local_service、map、scholarly_articles、third_party_reviews、twitter注意：ignore_targets_in と同じ要素の種類を含めることはできません例：\"find_targets_in\": [\"organic\", \"featured_snippet\"]このパラメータの詳細はヘルプセンターをご覧ください"
},
"ignore_targets_in": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "ターゲット検索から除外する SERP 要素の種類任意フィールドこのパラメータを有効にするには、stop_crawl_on_match も有効にする必要がありますターゲット一致を検索するときに除外する SERP 要素の種類を指定します指定可能な値：organic、paid、local_pack、featured_snippet、events、google_flights、images、jobs、knowledge_graph、local_service、map、scholarly_articles、third_party_reviews、twitter注意：find_targets_in と同じ要素の種類を含めることはできません例：\"ignore_targets_in\": [\"paid\", \"images\"]このパラメータの詳細はヘルプセンターをご覧ください"
}
},
"example": [
{
"language_code": "en",
"location_code": 2840,
"keyword": "albert einstein",
"calculate_rectangles": true
}
]
}
]
},
"example": [
{
"language_code": "en",
"location_code": 2840,
"keyword": "albert einstein",
"calculate_rectangles": true
}
]
}
```
## Responses
### 200 — 操作成功
Headers:
- `X-Request-Id` (string) — Felo サポートに問い合わせる際に伝えるリクエスト識別子。
**application/json**
Schema: object | null
```json
{
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedResponseInfo"
}
]
}
```
### 400 — リクエストを処理できませんでした。リクエストパラメータを確認してください。
### 401 — 有効な Felo API キーが必要です。
### 402 — 請求要件が満たされていないため、リクエストを続行できません。
### 403 — このアカウントにはこの操作を行う権限がありません。
### 429 — リクエストまたは支出の上限に達しました。
### 502 — サービスがリクエストを完了できませんでした。
### 503 — API または請求サービスが一時的に利用できません。
### 504 — リクエストの処理中にサービスがタイムアウトしました。
### default — エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります
**application/json**
Schema:
```json
{}
```
## Schema definitions
### Response36Afe1097B20_AiModeRectangleInfo
`#/components/schemas/Response36Afe1097B20_AiModeRectangleInfo`
```json
{
"type": "object",
"properties": {
"x": {
"type": [
"number",
"null"
],
"description": "x 軸座標\n結果スニペットの左上隅の x 軸座標。画面の左上隅を原点とします",
"format": "double"
},
"y": {
"type": [
"number",
"null"
],
"description": "y 軸座標\n結果スニペットの左上隅の y 軸座標。画面の左上隅を原点とします",
"format": "double"
},
"width": {
"type": [
"number",
"null"
],
"description": "要素の幅（ピクセル）",
"format": "double"
},
"height": {
"type": [
"number",
"null"
],
"description": "要素の高さ（ピクセル）",
"format": "double"
}
}
}
```
### Response36Afe1097B20_AmazonLabelElement
`#/components/schemas/Response36Afe1097B20_AmazonLabelElement`
```json
{
"type": "object",
"properties": {
"type": {
"type": [
"string",
"null"
],
"description": "要素の種類"
},
"title": {
"type": [
"string",
"null"
],
"description": "要素のタイトル"
},
"url": {
"type": [
"string",
"null"
],
"description": "絞り込みパラメーター付きの検索 URL"
},
"domain": {
"type": [
"string",
"null"
],
"description": "SERP のドメイン"
}
}
}
```
### Response36Afe1097B20_BaseResponseInfo
`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`
```json
{
"properties": {
"version": {
"type": [
"string",
"null"
],
"description": "API の現在のバージョン"
},
"status_code": {
"type": [
"integer",
"null"
],
"description": "一般的なステータスコード\nレスポンスコードの完全な一覧はこちらです"
},
"status_message": {
"type": [
"string",
"null"
],
"description": "一般的な情報メッセージ\n一般的な情報メッセージの完全な一覧はこちらです"
},
"time": {
"type": [
"string",
"null"
],
"description": "合計実行時間（秒）"
},
"cost": {
"type": [
"number",
"null"
],
"description": "タスクの総コスト（USD）",
"format": "double"
},
"tasks_count": {
"type": [
"integer",
"null"
],
"description": "tasks 配列内のタスク数",
"format": "int64"
},
"tasks_error": {
"type": [
"integer",
"null"
],
"description": "エラーで返された tasks 配列内のタスク数",
"format": "int64"
}
}
}
```
### Response36Afe1097B20_BaseResponseTaskInfo
`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`
```json
{
"properties": {
"id": {
"type": [
"string",
"null"
],
"description": "タスク識別子\n当社システム内で UUID 形式の一意のタスク識別子"
},
"status_code": {
"type": [
"integer",
"null"
],
"description": "タスクのステータスコード\nDataForSEO によって生成され、次の範囲の値になります: 10000-60000\nレスポンスコードの完全な一覧はこちらです"
},
"status_message": {
"type": [
"string",
"null"
],
"description": "タスクの情報メッセージ\n一般的な情報メッセージの完全な一覧はこちらです"
},
"time": {
"type": [
"string",
"null"
],
"description": "実行時間（秒）"
},
"cost": {
"type": [
"number",
"null"
],
"description": "タスクの総コスト（USD）",
"format": "double"
},
"result_count": {
"type": [
"integer",
"null"
],
"description": "result 配列内の要素数",
"format": "int64"
},
"path": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
},
"description": "URL パス"
},
"data": {
"type": [
"object",
"null"
],
"additionalProperties": {
"type": [
"object",
"null"
]
},
"description": "POST リクエストで指定したものと同じパラメーターを含みます"
}
}
}
```
### Response36Afe1097B20_BaseSerpApiElementItem
`#/components/schemas/Response36Afe1097B20_BaseSerpApiElementItem`
```json
{
"type": "object",
"properties": {
"type": {
"type": [
"string",
"null"
],
"description": "要素の種類"
},
"page": {
"type": [
"integer",
"null"
],
"description": "検索結果のページ番号
要素が配置されている SERP のページ番号を示します"
},
"position": {
"type": [
"string",
"null"
],
"description": "SERP における要素の配置
次の値を取ることができます:
left、right"
},
"xpath": {
"type": [
"string",
"null"
],
"description": "要素の XPath"
},
"rectangle": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_AiModeRectangleInfo"
}
],
"description": "矩形パラメータ
結果のスニペットの SERP におけるデカルト座標とピクセル寸法が含まれます
null になります（POST リクエストの calculate_rectangles が true に設定されていない場合）"
}
},
"additionalProperties": false,
"discriminator": {
"propertyName": "type",
"mapping": {
"paid": "#/components/schemas/Response36Afe1097B20_PaidSerpElementItem",
"organic": "#/components/schemas/Response36Afe1097B20_OrganicSerpElementItem",
"featured_snippet": "#/components/schemas/Response36Afe1097B20_FeaturedSnippetSerpElementItem",
"knowledge_graph": "#/components/schemas/Response36Afe1097B20_KnowledgeGraphSerpElementItem",
"top_stories": "#/components/schemas/Response36Afe1097B20_TopStoriesSerpElementItem",
"people_also_ask": "#/components/schemas/Response36Afe1097B20_PeopleAlsoAskSerpElementItem",
"people_also_search": "#/components/schemas/Response36Afe1097B20_PeopleAlsoSearchSerpElementItem",
"images": "#/components/schemas/Response36Afe1097B20_ImagesSerpElementItem",
"twitter": "#/components/schemas/Response36Afe1097B20_TwitterSerpElementItem",
"google_reviews": "#/components/schemas/Response36Afe1097B20_GoogleReviewsSerpElementItem",
"jobs": "#/components/schemas/Response36Afe1097B20_JobsSerpElementItem",
"map": "#/components/schemas/Response36Afe1097B20_MapSerpElementItem",
"app": "#/components/schemas/Response36Afe1097B20_AppSerpElementItem",
"local_pack": "#/components/schemas/Response36Afe1097B20_LocalPackSerpElementItem",
"carousel": "#/components/schemas/Response36Afe1097B20_CarouselSerpElementItem",
"video": "#/components/schemas/Response36Afe1097B20_VideoSerpElementItem",
"answer_box": "#/components/schemas/Response36Afe1097B20_AnswerBoxSerpElementItem",
"shopping": "#/components/schemas/Response36Afe1097B20_ShoppingSerpElementItem",
"google_flights": "#/components/schemas/Response36Afe1097B20_GoogleFlightsSerpElementItem",
"events": "#/components/schemas/Response36Afe1097B20_EventsSerpElementItem",
"related_searches": "#/components/schemas/Response36Afe1097B20_RelatedSearchesSerpElementItem",
"multi_carousel": "#/components/schemas/Response36Afe1097B20_MultiCarouselSerpElementItem",
"recipes": "#/components/schemas/Response36Afe1097B20_RecipesSerpElementItem",
"top_sights": "#/components/schemas/Response36Afe1097B20_TopSightsSerpElementItem",
"scholarly_articles": "#/components/schemas/Response36Afe1097B20_ScholarlyArticlesSerpElementItem",
"popular_products": "#/components/schemas/Response36Afe1097B20_PopularProductsSerpElementItem",
"stocks_box": "#/components/schemas/Response36Afe1097B20_StocksBoxSerpElementItem",
"find_results_on": "#/components/schemas/Response36Afe1097B20_FindResultsOnSerpElementItem",
"questions_and_answers": "#/components/schemas/Response36Afe1097B20_QuestionsAndAnswersSerpElementItem",
"hotels_pack": "#/components/schemas/Response36Afe1097B20_HotelsPackSerpElementItem",
"commercial_units": "#/components/schemas/Response36Afe1097B20_CommercialUnitsSerpElementItem",
"local_services": "#/components/schemas/Response36Afe1097B20_LocalServicesSerpElementItem",
"google_hotels": "#/components/schemas/Response36Afe1097B20_GoogleHotelsSerpElementItem",
"math_solver": "#/components/schemas/Response36Afe1097B20_MathSolverSerpElementItem",
"currency_box": "#/components/schemas/Response36Afe1097B20_CurrencyBoxSerpElementItem",
"product_considerations": "#/components/schemas/Response36Afe1097B20_ProductConsiderationsSerpElementItem",
"short_videos": "#/components/schemas/Response36Afe1097B20_ShortVideosSerpElementItem",
"refine_products": "#/components/schemas/Response36Afe1097B20_RefineProductsSerpElementItem",
"perspectives": "#/components/schemas/Response36Afe1097B20_PerspectivesSerpElementItem",
"discussions_and_forums": "#/components/schemas/Response36Afe1097B20_DiscussionsAndForumsSerpElementItem",
"compare_sites": "#/components/schemas/Response36Afe1097B20_CompareSitesSerpElementItem",
"knowledge_graph_carousel_item": "#/components/schemas/Response36Afe1097B20_KnowledgeGraphCarouselItemSerpElementItem",
"knowledge_graph_description_item": "#/components/schemas/Response36Afe1097B20_KnowledgeGraphDescriptionItemSerpElementItem",
"knowledge_graph_images_item": "#/components/schemas/Response36Afe1097B20_KnowledgeGraphImagesItemSerpElementItem",
"knowledge_graph_list_item": "#/components/schemas/Response36Afe1097B20_KnowledgeGraphListItemSerpElementItem",
"knowledge_graph_row_item": "#/components/schemas/Response36Afe1097B20_KnowledgeGraphRowItemSerpElementItem",
"knowledge_graph_hotels_booking_item": "#/components/schemas/Response36Afe1097B20_KnowledgeGraphHotelsBookingItemSerpElementItem",
"knowledge_graph_expanded_item": "#/components/schemas/Response36Afe1097B20_KnowledgeGraphExpandedItemSerpElementItem",
"knowledge_graph_part_item": "#/components/schemas/Response36Afe1097B20_KnowledgeGraphPartItemSerpElementItem",
"knowledge_graph_shopping_item": "#/components/schemas/Response36Afe1097B20_KnowledgeGraphShoppingItemSerpElementItem",
"knowledge_graph_ai_overview_item": "#/components/schemas/Response36Afe1097B20_KnowledgeGraphAiOverviewItemSerpElementItem",
"ai_overview": "#/components/schemas/Response36Afe1097B20_AiOverviewSerpElementItem",
"third_party_reviews": "#/components/schemas/Response36Afe1097B20_ThirdPartyReviewsSerpElementItem",
"dictionary": "#/components/schemas/Response36Afe1097B20_DictionarySerpElementItem",
"google_posts": "#/components/schemas/Response36Afe1097B20_GooglePostsSerpElementItem",
"mention_carousel": "#/components/schemas/Response36Afe1097B20_MentionCarouselSerpElementItem",
"podcasts": "#/components/schemas/Response36Afe1097B20_PodcastsSerpElementItem",
"visual_stories": "#/components/schemas/Response36Afe1097B20_VisualStoriesSerpElementItem",
"found_on_web": "#/components/schemas/Response36Afe1097B20_FoundOnWebSerpElementItem",
"explore_brands": "#/components/schemas/Response36Afe1097B20_ExploreBrandsSerpElementItem",
"courses": "#/components/schemas/Response36Afe1097B20_CoursesSerpElementItem"
}
}
}
```
### Response36Afe1097B20_RefinementChipsElement
`#/components/schemas/Response36Afe1097B20_RefinementChipsElement`
```json
{
"type": "object",
"properties": {
"type": {
"type": [
"string",
"null"
],
"description": "要素の種類"
},
"title": {
"type": [
"string",
"null"
],
"description": "要素のタイトル"
},
"url": {
"type": [
"string",
"null"
],
"description": "絞り込みパラメーター付きの検索 URL"
},
"domain": {
"type": [
"string",
"null"
],
"description": "SERP のドメイン"
},
"options": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_AmazonLabelElement"
}
]
},
"description": "さらなる検索絞り込みオプション"
}
}
}
```
### Response36Afe1097B20_RefinementChipsInfo
`#/components/schemas/Response36Afe1097B20_RefinementChipsInfo`
```json
{
"type": "object",
"properties": {
"type": {
"type": [
"string",
"null"
],
"description": "要素の種類"
},
"xpath": {
"type": [
"string",
"null"
],
"description": "要素の XPath"
},
"items": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_RefinementChipsElement"
}
]
},
"description": "要素の項目"
}
}
}
```
### Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedResponseInfo
`#/components/schemas/Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedResponseInfo`
```json
{
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo"
},
{
"type": "object",
"properties": {
"tasks": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedTaskInfo"
}
]
},
"description": "タスクの配列"
}
}
}
]
}
```
### Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedResultInfo
`#/components/schemas/Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedResultInfo`
```json
{
"type": "object",
"properties": {
"keyword": {
"type": [
"string",
"null"
],
"description": "POST 配列で受け取ったキーワード。キーワードはデコードされた %## とともに返されます（プラス記号 '+' は空白文字にデコードされます）"
},
"type": {
"type": [
"string",
"null"
],
"description": "要素の種類"
},
"se_domain": {
"type": [
"string",
"null"
],
"description": "POST 配列の検索エンジンドメイン"
},
"location_code": {
"type": [
"integer",
"null"
],
"description": "POST 配列の所在地コード"
},
"language_code": {
"type": [
"string",
"null"
],
"description": "POST 配列の言語コード"
},
"check_url": {
"type": [
"string",
"null"
],
"description": "検索エンジン結果への直接 URL。正確な結果が提供されたことを確認するために使用できます"
},
"datetime": {
"type": [
"string",
"null"
],
"description": "結果を受信した日時。UTC 形式：“yyyy-mm-dd hh-mm-ss +00:00”。例：2019-11-15 12:57:46 +00:00"
},
"spell": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_SpellInfo"
}
],
"description": "検索エンジンの自動修正。検索エンジンが修正されたキーワードの結果を返した場合、検索エンジンによって修正されたキーワードと自動修正のタイプを示します"
},
"refinement_chips": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_RefinementChipsInfo"
}
],
"description": "検索絞り込みチップ"
},
"item_types": {
"type": [
"array",
"null"
],
"items": {
"type": [
"string",
"null"
]
},
"description": "SERP の検索結果タイプは、SERP で見つかった検索結果のタイプ（items）を含みます。指定可能な項目タイプ：answer_box, app, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, third_party_reviews, images, jobs, knowledge_graph, local_pack, hotels_pack, map, organic, paid, people_also_ask, related_searches, people_also_search, shopping, top_stories, twitter, video, events, recipes, top_sights, scholarly_articles, popular_products, questions_and_answers, find_results_on, stocks_box, commercial_units, local_services, google_hotels, math_solver, currency_box,product_considerations, short_videos, refine_products, perspectives, discussions_and_forums, compare_sites, ai_overview"
},
"se_results_count": {
"type": [
"integer",
"null"
],
"description": "SERP の結果総数",
"format": "int64"
},
"pages_count": {
"type": [
"integer",
"null"
],
"description": "取得した検索結果の合計ページ数：結果内で取得された SERP の総数",
"format": "int64"
},
"items_count": {
"type": [
"integer",
"null"
],
"description": "items 配列で返される結果の数",
"format": "int64"
},
"items": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BaseSerpApiElementItem"
}
]
},
"description": "要素の項目"
}
}
}
```
### Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedTaskInfo
`#/components/schemas/Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedTaskInfo`
```json
{
"type": "object",
"allOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
},
{
"type": "object",
"properties": {
"result": {
"type": [
"array",
"null"
],
"items": {
"type": [
"object",
"null"
],
"oneOf": [
{
"$ref": "#/components/schemas/Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedResultInfo"
}
]
},
"description": "結果の配列"
}
}
}
]
}
```
### Response36Afe1097B20_SpellInfo
`#/components/schemas/Response36Afe1097B20_SpellInfo`
```json
{
"properties": {
"keyword": {
"type": [
"string",
"null"
],
"description": "検索エンジンの自動修正によって取得されたキーワード\n 結果は修正後のキーワードに対して提供されます"
},
"type": {
"type": [
"string",
"null"
],
"description": "自動修正のタイプ\n 指定可能な値：\n did_you_mean、showing_results_for、no_results_found_for、including_results_for\n 注意：Yahoo と Yandex がサポートする自動修正タイプは次のとおりです：\n including_results_for"
}
}
}
```