> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. # 实时 Google 酒店信息 HTML > Google 酒店信息将为您提供特定酒店实体在 [Google Hotels](http://www. 上可用的非结构化 HTML 数据 ## OpenAPI ````yaml openapi/zh/dataforseo.json POST /dataforseo/business_data/google/hotel_info/live/html openapi: 3.0.3 info: title: DataForSEO API version: 1.0.0 description: 通过 AIsa 统一网关提供的 DataForSEO API 端点。 servers: - url: https://api.aisa.one/apis/v1 security: - BearerAuth: [] paths: /dataforseo/business_data/google/hotel_info/live/html: post: summary: 实时 Google 酒店信息 HTML description: >- Google Hotel Info 将为您提供 [Google Hotels](http://www.google.com/travel/hotels) 平台上特定酒店实体的非结构化 HTML 数据，例如服务描述、位置详情、评分、设施、评论、图片、价格等。 operationId: post_dataforseo_business_data_google_hotel_info_live_html requestBody: required: true content: application/json: schema: type: object properties: hotel_identifier: type: string description: >- *酒店唯一标识符* **必填字段** Google 搜索中酒店实体的唯一标识符；可通过向高级 [Google SERP API](https://docs.dataforseo.com/v3/serp/google/organic/overview.md) 发出请求（包含在响应的 `hotels` 元素中），或通过 Business Data API 的 [Hotel Searches 端点](https://docs.dataforseo.com/v3/business_data/google/hotel_searches/task_post.md) 获取该值 示例：`ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE` priority: type: integer description: >- *任务优先级* 可选字段 可采用以下值：1 – 普通执行优先级（默认设置）2 – 高执行优先级 使用高执行优先级的任务将额外收费。费用可在[定价](https://dataforseo.com/pricing/business-data/google-hotels-api "定价")页面计算。 location_name: type: string description: >- *搜索引擎位置的完整名称* **如果未指定 `location_code` 或 `location_coordinate`，则此字段为必填字段**。**如果使用此字段，则无需指定 `location_code` 或 `location_coordinate`**。您可以单独请求 `https://api.dataforseo.com/v3/business_data/google/locations`，获取包含 `location_name` 的可用位置列表。示例：`London,England,United Kingdom` location_code: type: integer description: >- *搜索引擎位置代码* **如果未指定 `location_name` 或 `location_coordinate`，则为必填字段** **如果使用此字段，则无需指定 `location_name` 或 `location_coordinate`** 可通过向 `https://api.dataforseo.com/v3/business_data/google/locations` 单独发送请求，获取包含 `location_code` 的可用位置列表。示例：`2840` location_coordinate: type: string description: >- *位置的 GPS 坐标* **如果未指定 `location_name` 或 `location_code`，则为必填字段** **如果使用此字段，则无需指定 `location_name` 或 `location_code`** `location_coordinate` 参数应以 *“latitude,longitude”* 格式指定 *“latitude”* 和 *“longitude”* 的最大小数位数：7 **注意**：如果使用坐标设置位置，搜索将在最近的居民点进行；示例：`53.476225,-2.243572` language_name: type: string description: >- *搜索引擎语言的完整名称* **如果未指定 `language_code`，则为必填字段** **如果使用此字段，则无需指定 `language_code`** 您可以通过向 `https://api.dataforseo.com/v3/business_data/google/languages` 单独发送请求，获取包含 `language_name` 的可用语言列表。示例：`English` language_code: type: string description: >- *搜索引擎语言代码* **如果未指定 `language_name`，则为必填字段** **如果使用此字段，则无需指定 `language_name`** 可通过向 `https://api.dataforseo.com/v3/business_data/google/languages` 单独发送请求，获取可用语言及其 `language_code` 的列表 示例：`en` check_in: type: string description: >- *入住日期* 可选字段；如果未指定此字段，默认使用明天的日期；日期格式：`"yyyy-mm-dd"` 示例：`"2019-01-15"` check_out: type: string description: >- *退房日期* 可选字段；如果未指定此字段，系统将默认使用从现在起两天后的日期；日期格式：`"yyyy-mm-dd"`，示例：`"2019-01-15"` currency: type: string description: '*货币* 可选字段示例：`"USD"`' adults: type: integer description: '*成人数量* 可选字段，如果不指定此字段，默认使用两名成人；示例：`1`' children: type: array items: type: string description: >- *儿童人数和年龄*；可选字段；如果未指定此字段，搜索中将不包含儿童；如果要包含一名 14 岁儿童，请设置以下值：`[14]`；如果要包含一名 13 岁儿童和一名 8 岁儿童，请设置以下值：`[13,8]` tag: type: string description: >- *用户定义的任务标识符*，可选字段，*字符数上限为 255*。你可以使用此参数标识任务并将其与结果匹配；你可以在响应的 `data` 数组中找到指定的 `tag` 值 required: - hotel_identifier - location_name - location_code - location_coordinate - language_name - language_code responses: '200': description: 成功响应 content: application/json: schema: type: object properties: version: type: string description: '*API 的当前版本*' version.status_code: type: integer description: >- *常规状态代码* 您可以在[此处](https://docs.dataforseo.com/v3/appendix/errors.md)查看完整的响应代码列表。**注意：**我们强烈建议设计必要的系统来处理相关异常或错误情况 version.status_message: type: string description: >- *一般信息消息* 你可以在[此处](https://docs.dataforseo.com/v3/appendix/errors.md)查看一般信息消息的完整列表 version.time: type: string description: '*执行时间（秒）*' version.cost: type: number description: '*所有*任务*的总成本（美元）*' version.tasks_count: type: integer description: '***`tasks`** 数组中的任务数量*' version.tasks_error: type: integer description: '***`tasks`** 数组中返回错误的任务数量*' tasks: type: array items: type: string description: '*任务数组*' tasks.id: type: string description: >- *任务标识符* **我们系统中采用 [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier) 格式的唯一任务标识符** tasks.status_code: type: integer description: >- 由 DataForSEO 生成的*任务状态码*；范围为 10000-60000；你可以在[此处](https://docs.dataforseo.com/v3/appendix/errors.md)查看完整的响应代码列表 tasks.status_message: type: string description: >- *任务的提示信息* 你可以在[此处](https://docs.dataforseo.com/v3/appendix/errors.md)查看通用提示信息的完整列表 tasks.time: type: string description: '*执行时间（秒）*' tasks.cost: type: number description: '*任务成本（美元）*' tasks.result_count: type: integer description: '*`result` 数组中的元素数量*' tasks.path: type: array items: type: string description: '*URL 路径*' tasks.data: type: array items: type: string description: '*包含与您在 POST 请求中指定的参数相同的参数*' result: type: array items: type: string description: '*结果数组*' result.keyword: type: string description: '*指定为 `"hotel_id:$"` 的唯一酒店标识符*' result.type: type: string description: '*搜索结果类型* 在本例中为 `"hotel_info"`' result.se_domain: type: string description: '*POST 数组中的搜索引擎域名*' result.location_code: type: integer description: '*POST 数组中的位置代码*' result.language_code: type: string description: '*POST 数组中的语言代码*' result.datetime: type: string description: >- *收到结果的日期和时间*，采用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”；示例：`2019-11-15 12:57:46 +00:00` result.items_count: type: integer description: '***`items`** 数组中返回的结果数量*' items: type: array items: type: string description: '*HTML 页面*' items.page: type: integer description: '*返回的 HTML 页面的序列号*' items.date: type: string description: >- *HTML 页面扫描的日期和时间*，采用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”；示例：`2019-11-15 12:57:46 +00:00` items.html: type: string description: '*HTML 页面*' '400': description: 错误请求 '401': description: 未授权 '429': description: 超出速率限制 '500': description: 内部服务器错误 components: securitySchemes: BearerAuth: type: http scheme: bearer ````