# Live Google Hotel Info Advanced

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/business_data/google/hotel_info/live/advanced`

**Tags:** DataForSEO

One hotel's Google listing: rooms, amenities, prices and the booking options Google shows. Wrapped in DataForSEO's envelope: data in `tasks[0].result`, outcome in `tasks[0].status_code` - a rejected request still returns HTTP 200. The raw form is `post_dataforseo_business_google_hotel_info_live_html`, and the queued form `post_dataforseo_business_google_hotel_info_submit`. To find the hotel first use `post_dataforseo_business_google_hotel_searches_live`.

### Pricing reference

- Metering: Reported response cost.
- Reference request estimate: USD 0.2428.
- Reference customer multiplier: 1.0. Do not apply it again to a settled customer amount.

Reference metadata only, not an account quote, a guaranteed price or a spending cap. Resource credits are not Felo credits. Final charges follow Felo billing records.

## 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": {
          "hotel_identifier": {
            "type": "string",
            "description": "<em>unique hotel identifier</em><br><strong>required field</strong><br>unique identifier of a hotel entity in Google search;<br>you can obtain the value by making a request to Advanced <a href=\"/v3/serp/google/organic/overview/\" rel=\"noopener noreferrer\" target=\"_blank\">Google SERP API</a> (enclosed in the <code>hotels</code> element of the response), or the <a href=\"/v3/business_data/google/hotel_searches/task_post\" rel=\"noopener noreferrer\" target=\"_blank\">Hotel Searches endpoint</a> of Business Data API<br>example:<br><code>ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE</code>"
          },
          "location_name": {
            "type": "string",
            "description": "<em>full name of search engine location</em><br><strong>required field if you don't specify <code>location_code</code> or <code>location_coordinate</code></strong><br><strong>if you use this field, you don't need to specify <code>location_code</code> or <code>location_coordinate</code></strong><br>you can receive the list of available locations with <code>location_name</code> by making a separate request to <code>https://api.dataforseo.com/v3/business_data/google/locations</code><br>example:<br><code class=\"long-string\">London,England,United Kingdom</code>"
          },
          "location_code": {
            "type": "integer",
            "description": "<em>search engine location code</em><br><strong>required field if you don't specify <code>location_name</code>_or <code>location_coordinate</code></strong><br><strong>if you use this field, you don't need to specify <code>location_name</code> or <code>location_coordinate</code></strong><br>you can receive the list of available locations with <code>location_code</code> by making a separate request to the <code>https://api.dataforseo.com/v3/business_data/google/locations</code><br>example:<br><code class=\"long-string\">2840</code>n"
          },
          "location_coordinate": {
            "type": "string",
            "description": "<em>GPS coordinates of a location</em><br><strong>required field if you don't specify <code>location_name</code>_or <code>location_code</code></strong><br><strong>if you use this field, you don't need to specify <code>location_name</code> or <code>location_code</code></strong><br><code>location_coordinate</code> parameter should be specified in the <em>\"latitude, longitude\"</em> format<br>the maximum number of decimal digits for <em>\"latitude\"</em> and <em>\"longitude\"</em>: 7<br><strong>Note</strong>: if the coordinates are used to set a location, the search will occur in the nearest settlement;<br>example:<br><code class=\"long-string\">53.476225,-2.243572</code>n"
          },
          "language_name": {
            "type": "string",
            "description": "<em>full name of search engine language</em><br><strong>required field if you don't specify <code>language_code</code></strong><br><strong>if you use this field, you don't need to specify <code>language_code</code></strong><br>you can receive the list of available languages with <code>language_name</code> by making a separate request to <code>https://api.dataforseo.com/v3/business_data/google/languages</code><br>example:<br><code class=\"long-string\">English</code>"
          },
          "language_code": {
            "type": "string",
            "description": "<em>search engine language code</em><br><strong>required field if you don't specify <code>language_name</code></strong><br><strong>if you use this field, you don't need to specify <code>language_name</code></strong><br>you can receive the list of available languages with their <code>language_code</code>_by making a separate request to <code>https://api.dataforseo.com/v3/business_data/google/languages</code><em><br></em>example:<em><br></em><code class=\"long-string\">en</code>n"
          },
          "check_in": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>check-in date</em><br>optional field<br>if you don't specify this field, tomorrow's date will be used by default;<br>the value must not be earlier than today's date<br>date format: <code>\"yyyy-mm-dd\"</code><br>example:<br><code>\"2019-01-15\"</code>"
          },
          "check_out": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>check-out date</em><br>optional field<br>if you don't specify this field, our system will apply the date of two days from now by default;<br><strong>Note:</strong> the value cannot be less than or equal to <code>check_in</code>;<br>the range between <code>check_in</code> and <code>check_out</code> values cannot exceed 30 days<br>date format: <code>\"yyyy-mm-dd\"</code><br>example:<br><code>\"2019-01-15\"</code>"
          },
          "currency": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>currency</em><br>optional field<br>example:<br><code>\"USD\"</code>"
          },
          "adults": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>number of adults</em><br>optional field<br>if you don't specify this field, two adults will be used by default<br>example:<br><code>1</code>"
          },
          "children": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "<em>number and age of children</em><br>optional field<br>if you don't specify this field, no children will be included in the search;<p>set the following value if you want to include one 14-years-old child:<br><code>[14]</code><br>set the following value if you want to include one 13-years-old child and one 8-years-old child:<br><code>[13,8]</code>"
          },
          "load_prices_by_dates": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "<em>load hotel stay prices by dates</em><br>optional field<br>if you specify this parameter with <code>true</code>, the response will include the <code>prices_by_dates</code> array with hotel stay prices divided by dates<br>if you use this parameter, you will be charged <strong>double the base price for a request</strong>"
          },
          "prices_start_date": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>start date to load prices by dates</em><br>optional field<br>to use this parameter, you must specify <code>load_prices_by_dates</code> with <code>true</code><br>if this parameter is not specified, the start date is set to <code>check_in</code> date<br>date format: <code>yyyy-mm-dd</code><br>example:<br><code>2025-05-20</code>"
          },
          "prices_end_date": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>end date to load prices by dates</em><br>optional field<br>to use this parameter, you must specify <code>load_prices_by_dates</code> with <code>true</code><br>if this parameter is not specified, you will get prices by date for the month <br>date format: <code>yyyy-mm-dd</code><br>example:<br><code>2025-05-21</code>"
          },
          "prices_date_range": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>predefined period for retrieving daily price data</em><br>optional field<br>to use this parameter, you must specify <code>load_prices_by_dates</code> with <code>true</code><br>if the <code>prices_start_date </code>is not specified, the start date is set to <code>check_in</code> date<br>possible values: <code>month</code>, <code>three_months</code>, <code>six_months</code>, <code>year</code><br>default value: <code>month</code>"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>user-defined task identifier</em><br>optional field<br><em>the character limit is 255</em><br>you can use this parameter to identify the task and match it with the result<br>you will find the specified <code>tag</code> value in the <code>data</code> object of the response"
          }
        },
        "example": [
          {
            "language_code": "en",
            "location_name": "New York,New York,United States",
            "hotel_identifier": "CgoI-KWyzenM_MV3EAE"
          }
        ]
      }
    ]
  },
  "example": [
    {
      "language_code": "en",
      "location_name": "New York,New York,United States",
      "hotel_identifier": "CgoI-KWyzenM_MV3EAE"
    }
  ]
}
```

## Responses

### 200 — Successful operation

Headers:
- `X-Request-Id` (string) — Request identifier to include when contacting Felo support.

**application/json**

Schema: object | null

```json
{
  "type": [
    "object",
    "null"
  ],
  "oneOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BusinessDataGoogleHotelInfoLiveAdvancedResponseInfo"
    }
  ]
}
```

### 400 — The request could not be processed. Check the request parameters.

### 401 — A valid Felo API key is required.

### 402 — The request cannot proceed because a billing requirement is not met.

### 403 — The account is not permitted to perform this operation.

### 429 — A request or spending limit has been reached.

### 502 — The service could not complete the request.

### 503 — The API or billing service is temporarily unavailable.

### 504 — The service timed out while processing the request.

### default — Error response; upstream passthrough responses may use provider formats

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "the current version of the API"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "general status code\nyou can find the full list of the response codes here"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "general informational message\nyou can find the full list of general informational messages here"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "total execution time, seconds"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "total tasks cost, USD",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "the number of tasks in the tasks array",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "the number of tasks in the tasks array returned with an error",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "task identifier\nunique task identifier in our system in the UUID format"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "status code of the task\ngenerated by DataForSEO, can be within the following range: 10000-60000\nyou can find the full list of the response codes here"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "informational message of the task\nyou can find the full list of general informational messages here"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "execution time, seconds"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "total tasks cost, USD",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "number of elements in the result array",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "URL path"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "contains the same parameters that you specified in the POST request"
    }
  }
}
```

### Response36Afe1097B20_BusinessDataGoogleHotelInfoLiveAdvancedResponseInfo

`#/components/schemas/Response36Afe1097B20_BusinessDataGoogleHotelInfoLiveAdvancedResponseInfo`

```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_BusinessDataGoogleHotelInfoLiveAdvancedTaskInfo"
              }
            ]
          },
          "description": "<em>array of tasks</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_BusinessDataGoogleHotelInfoLiveAdvancedResultInfo

`#/components/schemas/Response36Afe1097B20_BusinessDataGoogleHotelInfoLiveAdvancedResultInfo`

```json
{
  "type": "object",
  "properties": {
    "hotel_identifier": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>identifier received in a POST array</em><br>this field will contain the <code>hotel_identifier</code> parameter specified when setting a task;<br>example:<br><code>CgoI-KWyzenM_MV3EAE</code>"
    },
    "location_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>location code in a POST array</em>"
    },
    "language_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>language code in a POST array</em>"
    },
    "check_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>direct URL to search engine results</em><br>you can use it to make sure that we provided accurate results"
    },
    "datetime": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>date and time when the result was received</em><br>in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”<br>example:<br><code class=\"long-string\">2019-11-15 12:57:46 +00:00</code>"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>hotel title</em><br>the title of the hotel entity for which the results are collected"
    },
    "stars": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>hotel class rating</em><br>class rating that ranges between 1-5 stars and displayed after review ratings in hotel summary"
    },
    "stars_description": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>hotel class rating</em><br>class rating that ranges between 1-5 stars and displayed after review ratings in the hotel summary"
    },
    "address": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>hotel address</em><br>physical address of the hotel"
    },
    "phone": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>hotel phone number</em><br>contact phone number of the hotel"
    },
    "about": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_HotelAboutInfo"
        }
      ],
      "description": "<em>information about the hotel</em>"
    },
    "location": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_HotelLocationInfo"
        }
      ],
      "description": "<em>information about the hotel location</em><br>information about the location where the hotel is located"
    },
    "reviews": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_HotelReviewInfo"
        }
      ],
      "description": "<em>hotel reviews by criteria</em><br>information about reviews of the hotel entity"
    },
    "overview_images": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "<em>images displayed in the hotel overview</em><br>array containing URLs to images displayed in the hotel overview"
    },
    "prices": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_HotelPriceInfo"
        }
      ],
      "description": "<em>pricing details of the hotel entity</em><br>contains information about the hotel's prices"
    }
  }
}
```

### Response36Afe1097B20_BusinessDataGoogleHotelInfoLiveAdvancedTaskInfo

`#/components/schemas/Response36Afe1097B20_BusinessDataGoogleHotelInfoLiveAdvancedTaskInfo`

```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_BusinessDataGoogleHotelInfoLiveAdvancedResultInfo"
              }
            ]
          },
          "description": "<em>array of results</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_HotelAboutInfo

`#/components/schemas/Response36Afe1097B20_HotelAboutInfo`

```json
{
  "type": "object",
  "properties": {
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>description of the hotel</em><br>the description of the hotel entity for which the results are collected"
    },
    "sub_descriptions": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "<em>additional description of the hotel</em><br>details about the hotel provided in addition to the description"
    },
    "check_in_time": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_TimeInfo"
        }
      ],
      "description": "<em>hotel check-in time</em><br>check-in time indicated in the hotel listing"
    },
    "check_out_time": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_TimeInfo"
        }
      ],
      "description": "<em>hotel check-out time</em><br>check-out time indicated in the hotel listing"
    },
    "full_address": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>full address of the hotel</em><br>address of the hotel indicated in the standardised format"
    },
    "domain": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>hotel domain</em><br>domain of the hotel's website"
    },
    "url": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>hotel url</em><br>URL to the hotel's website indicated in the listing"
    },
    "amenities": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_HotelAmenityInfo"
          }
        ]
      },
      "description": "<em>hotel amenities</em><br>information about hotel amenities"
    },
    "popular_amenities": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_HotelAmenityItemInfo"
          }
        ]
      },
      "description": "<em>hotel amenities</em><br>information about hotel amenities labelled as \"popular\""
    }
  }
}
```

### Response36Afe1097B20_HotelAmenityInfo

`#/components/schemas/Response36Afe1097B20_HotelAmenityInfo`

```json
{
  "type": "object",
  "properties": {
    "category": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>standardised category of the ammenity</em>"
    },
    "category_label": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>label of the category</em>"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_HotelAmenityItemInfo"
          }
        ]
      },
      "description": "<em>specific amenities and details</em>"
    }
  }
}
```

### Response36Afe1097B20_HotelAmenityItemInfo

`#/components/schemas/Response36Afe1097B20_HotelAmenityItemInfo`

```json
{
  "type": "object",
  "properties": {
    "amenity": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>standardised amenity name</em>"
    },
    "amenity_label": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>displayed amenity name</em>"
    },
    "hint": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>standardised details about the amenity</em>"
    },
    "hint_label": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>displayed details about the amenity</em>"
    },
    "is_available": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "<em>indicates whether the <code>amenity</code> is available in the hotel</em>"
    }
  }
}
```

### Response36Afe1097B20_HotelInfoPriceOffer

`#/components/schemas/Response36Afe1097B20_HotelInfoPriceOffer`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "type of element"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>title of the hotel</em>"
    },
    "price": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>price per night</em>"
    },
    "currency": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>price currency</em><br><code>USD</code> is applied by default, unless specified in the POST array"
    },
    "url": {
      "type": [
        "string",
        "null"
      ],
      "description": "url of the price offer\nURL to the page of the website where price offer appears"
    },
    "max_visitors": {
      "type": [
        "integer",
        "null"
      ],
      "description": "the maximal number of visitors\nthe maximum number of visitors for which the price offer is valid"
    },
    "offer_images": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "price offer images\nURLs of the images featured in the price offer"
    },
    "free_cancellation_until": {
      "type": [
        "string",
        "null"
      ],
      "description": "date until free cancellation is available\nin the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”\nequals null if free cancellation is not available for the selected dates"
    }
  },
  "description": "featured price offers"
}
```

### Response36Afe1097B20_HotelLocationInfo

`#/components/schemas/Response36Afe1097B20_HotelLocationInfo`

```json
{
  "type": "object",
  "properties": {
    "neighborhood": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>name of the neighborhood where the hotel is located</em>"
    },
    "neighborhood_description": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>description of the neighborhood where the hotel is located</em>"
    },
    "maps_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>url to the location of the hotel in google maps</em>"
    },
    "overall_score": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>overall score of the hotel location</em><br>indicates the overall score of the hotel's location in the range from 1 to 5;<br>calculated based on data from the hotel's proximity to nearby things to do and restaurants, transportation, and airports;<br>note that the criteria are not weighted equally in the overall score"
    },
    "score_by_categories": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "number",
          "null"
        ],
        "format": "double"
      },
      "description": "<em>category scores of the hotel location</em><br>the scores of the hotel's location tied to the categories that indicate the proximity to nearby things to do, restaurants, transportation, and airports;"
    },
    "latitude": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>hotel latitude</em><br>latitude coordinates of the hotel's location<br>example:<br><code>39.4806397</code>"
    },
    "longitude": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>hotel longitude</em><br>latitude coordinates of the hotel's location<br>example:<br><code>-106.0512973</code>"
    },
    "location_chain": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_LocationChain"
          }
        ]
      },
      "description": "<em>elements of the location chain</em><br>additional parameters of each element of the location chain"
    }
  }
}
```

### Response36Afe1097B20_HotelPriceInfo

`#/components/schemas/Response36Afe1097B20_HotelPriceInfo`

```json
{
  "type": "object",
  "properties": {
    "price": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>price per night</em>"
    },
    "price_without_discount": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>full price per night without a discount applied</em>",
      "format": "int64"
    },
    "currency": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>price currency</em><br><code>USD</code> is applied by default, unless specified in the POST array"
    },
    "discount_text": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>text about a discount applied</em>"
    },
    "check_in": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>check-in date and time</em><br>in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”<br>example:<br><code>2019-11-15 12:57:46 +00:00</code>"
    },
    "check_out": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>check-out date and time</em><br>in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”<br>example:<br><code>2019-11-15 12:57:46 +00:00</code>"
    },
    "visitors": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>number of hotel visitors for this price</em>"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_HotelPriceItemInfo"
          }
        ]
      },
      "description": "<em>encountered item types</em><br>types of search engine results encountered in the <code>items</code> array;<br>possible item types: <code>hotel_search_item</code>"
    },
    "prices_by_dates": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_PricesByDates"
          }
        ]
      }
    }
  }
}
```

### Response36Afe1097B20_HotelPriceItemInfo

`#/components/schemas/Response36Afe1097B20_HotelPriceItemInfo`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "type of element"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>title of the hotel</em>"
    },
    "price": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>price per night</em>"
    },
    "currency": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>price currency</em><br><code>USD</code> is applied by default, unless specified in the POST array"
    },
    "url": {
      "type": [
        "string",
        "null"
      ],
      "description": "third-party page url\nURL to the third-party website page with pricing information"
    },
    "domain": {
      "type": [
        "string",
        "null"
      ],
      "description": "third-party domain\ndomain of the third-party website page with pricing information"
    },
    "is_paid": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "<em>indicates a paid hotel listing</strong></em><br>if <code>true</code>, related <code>hotel_search_item</code> is a paid ad<br>if <code>false</code>, related <code>hotel_search_item</code> is an organic hotel listing"
    },
    "official_site": {
      "type": [
        "boolean",
        "null"
      ]
    },
    "free_cancellation_until": {
      "type": [
        "string",
        "null"
      ],
      "description": "date until which free cancellation is available\nin the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”\nequals null if free cancellation is not available for the selected dates"
    },
    "offers": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_HotelInfoPriceOffer"
          }
        ]
      }
    }
  }
}
```

### Response36Afe1097B20_HotelReviewInfo

`#/components/schemas/Response36Afe1097B20_HotelReviewInfo`

```json
{
  "type": "object",
  "properties": {
    "value": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>overall hotel rating based on customer votes</em>"
    },
    "votes_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>number of customer votes</em><br>the number of customer votes included in the calculation of the hotel rating",
      "format": "int64"
    },
    "mentions": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_ReviewMentionInfo"
          }
        ]
      },
      "description": "<em>hotel mentions</em><br>information about hotel reviews by criteria"
    },
    "rating_distribution": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "integer",
          "null"
        ],
        "format": "Int64"
      },
      "description": "<em>rating distribution by votes</em><br>the distribution of votes across the rating in the range from 1 to 5"
    },
    "other_sites_reviews": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_OtherSitesReviewsInfo"
          }
        ]
      },
      "description": "<em>reviews on third-party sites</em><br>reviews from third-party sites"
    }
  }
}
```

### Response36Afe1097B20_LocationChain

`#/components/schemas/Response36Afe1097B20_LocationChain`

```json
{
  "type": "object",
  "properties": {
    "card_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>card identifier</em>"
    },
    "feature_id": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>feature identifier</em><br>learn more about the identifier in <a href=\"https://dataforseo.com/help-center/what-is-cid-place-id-feature-id\" target=\"_blank\" rel=\"noopener noreferrer\">this help center article</a>"
    },
    "cid": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>client id</em><br>learn more about the identifier in <a href=\"https://dataforseo.com/help-center/what-is-cid-place-id-feature-id\" target=\"_blank\" rel=\"noopener noreferrer\">this help center article</a>"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>title of the element in the location chain</em>"
    }
  }
}
```

### Response36Afe1097B20_OtherSitesReviewsInfo

`#/components/schemas/Response36Afe1097B20_OtherSitesReviewsInfo`

```json
{
  "type": "object",
  "properties": {
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>review title</em><br>contains a name of the third-party site where review initially appeared"
    },
    "url": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>review url</em><br>URL to the a third-party site where review initially appeared"
    },
    "review_text": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>review text</em><br>text of the review"
    },
    "rating": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_RatingInfo"
        }
      ],
      "description": "<em>rating in the review</em><br>information about the rating enclosed in the review on a third-party site"
    }
  }
}
```

### Response36Afe1097B20_PricesByDates

`#/components/schemas/Response36Afe1097B20_PricesByDates`

```json
{
  "type": "object",
  "properties": {
    "price": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>price per night</em>"
    },
    "currency": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>price currency</em><br><code>USD</code> is applied by default, unless specified in the POST array"
    },
    "check_in_date": {
      "type": [
        "string",
        "null"
      ]
    },
    "check_out_date": {
      "type": [
        "string",
        "null"
      ]
    }
  }
}
```

### Response36Afe1097B20_RatingInfo

`#/components/schemas/Response36Afe1097B20_RatingInfo`

```json
{
  "properties": {
    "rating_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "the type of rating\nhere you can find the following elements: Max5, Percents, CustomMax"
    },
    "value": {
      "type": [
        "number",
        "null"
      ],
      "description": "the value of the rating",
      "format": "double"
    },
    "votes_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "the amount of feedback",
      "format": "int64"
    },
    "rating_max": {
      "type": [
        "integer",
        "null"
      ],
      "description": "the maximum value for a rating_type"
    }
  }
}
```

### Response36Afe1097B20_ReviewMentionInfo

`#/components/schemas/Response36Afe1097B20_ReviewMentionInfo`

```json
{
  "type": "object",
  "properties": {
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>title of the evaluated criterion</em>"
    },
    "positive_score": {
      "type": [
        "number",
        "null"
      ],
      "description": "<em>positive score by criterion</em>"
    },
    "positive_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>count of positive reviews by criterion</em>",
      "format": "int64"
    },
    "negative_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>count of negative reviews by criterion</em>",
      "format": "int64"
    },
    "total_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>count of all reviews by criterion</em>",
      "format": "int64"
    },
    "visible_by_default": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "<em>element is visible by default</em><br>indicates whether the review element is visible by default"
    }
  }
}
```

### Response36Afe1097B20_TimeInfo

`#/components/schemas/Response36Afe1097B20_TimeInfo`

```json
{
  "type": "object",
  "properties": {
    "hour": {
      "type": [
        "integer",
        "null"
      ],
      "description": "hours in the 24-hour format"
    },
    "minute": {
      "type": [
        "integer",
        "null"
      ],
      "description": "minutes"
    }
  }
}
```