DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
ライブ Google ホテル情報 HTML
post_dataforseo_business_google_hotel_info_live と同じホテルリスティングを、生の HTML で返します。DataForSEO のエンベロープ構造です。データは tasks[0].result、結果ステータスは tasks[0].status_code に格納され、拒否されたリクエストでも HTTP 200 が返ります。
料金の参考情報
- 計量方式：レスポンスで報告されるコスト。
- 参考リクエスト見積もり：0.2428 USD。
- 参考顧客乗数：1.0。確定済みの顧客金額に再適用しないでください。
参照用のメタデータのみであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。
- 型: array (object | null)[]
- adults型: integer | null
大人の人数
任意フィールド
このフィールドを指定しない場合、2 名の大人がデフォルトで使用されます
例：1 - check型: string | null
_in チェックイン日
任意フィールド
このフィールドを指定しない場合、明日の日付がデフォルトで使用されます；
日付形式："yyyy-mm-dd"
例："2019-01-15" - check型: string | null
_out チェックアウト日
任意フィールド
このフィールドを指定しない場合、当社のシステムはデフォルトで 2 日後の日付を適用します；
日付形式："yyyy-mm-dd"
例："2019-01-15" - children型: array string[] | null
子供の人数と年齢
任意フィールド
このフィールドを指定しない場合、検索に子供は含まれません；14 歳の子供を 1 名含める場合は、次の値を設定します：
[14]
13 歳の子供 1 名と 8 歳の子供 1 名を含める場合は、次の値を設定します：[13,8] - currency型: string | null
通貨
任意フィールド
例："USD" - hotel型: string
_identifier - language型: string
_code 検索エンジンの言語コード
language_nameを指定しない場合は必須フィールド
このフィールドを使用する場合、language_nameを指定する必要はありませんlanguage_codeを付した利用可能な言語のリストは、https://api.dataforseo.com/v3/business_data/google/languagesに個別にリクエストして取得できます
例：en - language型: string
_name 検索エンジンの言語の正式名
language_codeを指定しない場合は必須フィールド
このフィールドを使用する場合、language_codeを指定する必要はありませんlanguage_nameを付した利用可能な言語のリストは、https://api.dataforseo.com/v3/business_data/google/languagesに個別にリクエストして取得できます
例：English - location型: integer
_code 検索エンジンのロケーションコード
location_nameまたはlocation_coordinateを指定しない場合は必須フィールド
このフィールドを使用する場合、location_nameまたはlocation_coordinateを指定する必要はありませんlocation_codeを含む利用可能なロケーションの一覧は、https://api.dataforseo.com/v3/business_data/google/locationsに個別にリクエストして取得できます
例：2840 - location型: string
_coordinate ロケーションの GPS 座標
location_nameまたはlocation_codeを指定しない場合は必須フィールド
このフィールドを使用する場合、location_nameまたはlocation_codeを指定する必要はありませんlocation_coordinateパラメータは "latitude,longitude" 形式で指定します
"latitude" と "longitude" の小数点以下の最大桁数：7
注意：座標を使用してロケーションを設定する場合、検索は最も近い集落で行われます；
例：53.476225,-2.243572 - location型: string
_name 検索エンジンのロケーションの正式名
location_codeまたはlocation_coordinateを指定しない場合は必須フィールド
このフィールドを使用する場合、location_codeまたはlocation_coordinateを指定する必要はありませんlocation_nameを含む利用可能なロケーションの一覧は、https://api.dataforseo.com/v3/business_data/google/locationsに個別にリクエストして取得できます
例：London,England,United Kingdom - priority型: integer | null
- tag型: string | null
ユーザー定義のタスク識別子
任意フィールド
文字数上限は 255 です
このパラメーターを使ってタスクを識別し、結果と照合できます
指定したtagの値は、レスポンスのdata配列に含まれます
- 型: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoLiveHtmlResponseInfo200
- 型: number | null 形式: doublecost
タスクの総コスト（USD）
- 型: integer | nullstatus
_code 一般的なステータスコード レスポンスコードの完全な一覧はこちらです
- 型: string | nullstatus
_message 一般的な情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- 型: array (object | null)[] | nulltasks
タスクの配列
- 型: object | null · Response36Afe1097B20_BusinessDataGoogleHotelInfoLiveHtmlTaskInfo
- cost型: number | null 形式: double
タスクの総コスト（USD）
- data型: object | null
POST リクエストで指定したものと同じパラメーターを含みます
- property型: object | null
Name
- id型: string | null
タスク識別子 当社システム内で UUID 形式の一意のタスク識別子
- path型: array (string | null)[] | null
URL パス
- result型: array (object | null)[] | null
結果の配列
- datetime型: string | null
結果を受信した日時
UTC 形式：“yyyy-mm-dd hh-mm-ss +00:00”
例：2019-11-15 12:57:46 +00:00 - items型: array (object | null)[] | null
HTML ページ
- date型: string | null
HTML ページがスキャンされた日時
UTC 形式：“yyyy-mm-dd hh-mm-ss +00:00”
例：2019-11-15 12:57:46 +00:00 - html型: string | null
HTML ページ
- page型: integer | null
返された HTML ページのシリアル番号
- items型: integer | null 形式: int64
_count items配列で返された結果数 - keyword型: string | null
"hotel_id:$"として指定された一意のホテル識別子 - language型: string | null
_code POST 配列内の言語コード
- location型: integer | null
_code POST 配列内のロケーションコード
- se型: string | null
_domain - type型: string | null
要素の種類
- result型: integer | null 形式: int64
_count result 配列内の要素数
- status型: integer | null
_code タスクのステータスコード DataForSEO によって生成され、次の範囲の値になります: 10000-60000 レスポンスコードの完全な一覧はこちらです
- status型: string | null
_message タスクの情報メッセージ 一般的な情報メッセージの完全な一覧はこちらです
- time型: string | null
実行時間（秒）
- 型: integer | null 形式: int64tasks
_count tasks 配列内のタスク数
- 型: integer | null 形式: int64tasks
_error エラーで返された tasks 配列内のタスク数
- 型: string | nulltime
合計実行時間（秒）
- 型: string | nullversion
API の現在のバージョン
application/json - 400
リクエストを処理できませんでした。リクエストパラメータを確認してください。
- 401
有効な Felo API キーが必要です。
- 402
請求要件が満たされていないため、リクエストを続行できません。
- 403
このアカウントにはこの操作を行う権限がありません。
- 429
リクエストまたは支出の上限に達しました。
- 502
サービスがリクエストを完了できませんでした。
- 503
API または請求サービスが一時的に利用できません。
- 504
リクエストの処理中にサービスがタイムアウトしました。
- default
エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/hotel_info/live/html \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_name": "New York,New York,United States",
"hotel_identifier": "ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE"
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"keyword": null,
"type": null,
"se_domain": null,
"location_code": null,
"language_code": null,
"datetime": null,
"items_count": null,
"items": [
{
"page": null,
"date": null,
"html": null
}
]
}
]
}
]
}