> ## 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. # Live Google Hotel Searches Tasks > Hotel Searches API provides results containing information about different hotels listed on Google Hotels. ## OpenAPI ````yaml openapi/dataforseo.json POST /dataforseo/business_data/google/hotel_searches/live openapi: 3.0.3 info: title: DataForSEO API version: 1.0.0 description: DataForSEO API endpoints exposed through the AIsa unified gateway. servers: - url: https://api.aisa.one/apis/v1 security: - BearerAuth: [] paths: /dataforseo/business_data/google/hotel_searches/live: post: summary: Live Google Hotel Searches Tasks description: >- Hotel Searches API provides results containing information about different hotels listed on Google Hotels. The provided results are specific to the selected location (see [the List of Locations](https://docs.dataforseo.com/v3/business_data/google/locations.md)) and language (see [the List of Languages](https://docs.dataforseo.com/v3/business_data/google/languages.md)) settings. operationId: post_dataforseo_business_data_google_hotel_searches_live requestBody: required: true content: application/json: schema: type: object properties: keyword: type: string description: >- *keyword* optional field the keyword you specify is used to search for the list of hotels; if you don’t use this field, we will return the list of hotels found in a specified location; you can specify **up to 700 characters** in the `keyword` filed **all %## will be decoded (plus character ‘+’ will be decoded to a space character)** if you need to use the “%” character for your `keyword`, please specify it as “%25”; **Note:** in order to obtain accurate search results, the location name is appended to the keyword automatically learn more about rules and limitations of `keyword` and `keywords` fields in DataForSEO APIs in this [Help Center article](https://dataforseo.com/help-center/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis) location_name: type: string description: >- *full name of search engine location* **required field if you don’t specify `location_code` or `location_coordinate`** **if you use this field, you don’t need to specify `location_code` or `location_coordinate`** you can receive the list of available locations with `location_name` by making a separate request to `https://api.dataforseo.com/v3/business_data/google/locations` example: `London,England,United Kingdom` **Note:** in order to obtain accurate search results, the `location_name` you specify will be automatically appended to the keyword location_code: type: integer description: >- *search engine location code* **required field if you don’t specify `location_name` or `location_coordinate`** **if you use this field, you don’t need to specify `location_name` or `location_coordinate`** you can receive the list of available locations with `location_code` by making a separate request to the `https://api.dataforseo.com/v3/business_data/google/locations` example: `2840` location_coordinate: type: string description: >- *GPS coordinates of a location* **required field if you don’t specify `location_name` or `location_code`** **if you use this field, you don’t need to specify `location_name` or `location_code`** `location_coordinate` parameter should be specified in the *“latitude,longitude”* format the maximum number of decimal digits for *“latitude”* and *“longitude”*: 7 **Note**: if the coordinates are used to set a location, the search will occur in the nearest settlement example: `53.476225,-2.243572` language_name: type: string description: >- *full name of search engine language* **required field if you don’t specify `language_code`** **if you use this field, you don’t need to specify `language_code`** you can receive the list of available languages with `language_name` by making a separate request to `https://api.dataforseo.com/v3/business_data/google/languages` example: `English` language_code: type: string description: >- *search engine language code* **required field if you don’t specify `language_name`** **if you use this field, you don’t need to specify `language_name`** you can receive the list of available languages with their `language_code` by making a separate request to `https://api.dataforseo.com/v3/business_data/google/languages` example: `en` depth: type: integer description: >- *parsing depth* optional field number of results in Google Hotels default value: `20` organic results max value: `140` **Note:** your account will be billed per each 20 organic results regardless of paid listings in the response; thus, setting a depth above `20` may result in additional charges if Google Hotels return more than 20 results; if the specified depth is higher than the number of results in the response, the difference will be refunded automatically to your account balance check_in: type: string description: >- *check-in date* optional field if you don’t specify this field, tomorrow’s date will be used by default; date format: `"yyyy-mm-dd"` example: `"2019-01-15"` **Note:** the value cannot precede the today’s date check_out: type: string description: >- *check-out date* optional field if you don’t specify this field, our system will apply the date of two days from now by default; date format: `"yyyy-mm-dd"` example: `"2019-01-15"` **Note:** the value cannot be less than or equal to `check_in`; the range between `check_in` and `check_out` values cannot exceed 30 days currency: type: string description: '*currency* optional field example: `"USD"`' adults: type: integer description: >- *number of adults* optional field if you don’t specify this field, the default value of `2` will be applied; **note** that you can specify up to 6 persons including both adults and children example: `1` children: type: array items: type: string description: >- *number and age of children* optional field if you don’t specify this field, no children will be included in the search; age of child can be from `0` to `17`; **note** that you can specify up to 6 persons including both adults and children set the following value if you want to include one 14-year-old child: `[14]` set the following value if you want to include one 13-year-old child and one 8-year-old child: `[13,8]` stars: type: array items: type: string description: >- *hotel stars* optional field set this field to `[5]` if you want to get the list of 5-star hotels only example: `[3,4,5]` min_rating: type: number description: >- *minimum rating* optional field you can use this field to specify guest rating higher than a certain value example: `2.5` sort_by: type: string description: >- *results sorting parameters* optional field you can use this field to sort the results possible types of sorting: `relevance` – sort by most relevant `lowest_price` – sort by the lowest price `highest_rating` – sort by highest rating `most_reviewed` – sort by most reviewed default value: `relevance` min_price: type: integer description: >- *minimum price per night* optional field the currency of this value depends on the `currency` field example: `100` max_price: type: integer description: >- *maximum price per night* optional field the currency of this value depends on the `currency` field example: `600` free_cancellation: type: boolean description: >- *hotels with a free cancellation* optional field set this field to `true` if you want to get the list of hotels with free cancellation of reservations default value: `false` is_vacation_rentals: type: boolean description: >- *search for vacation rentals* optional field set this field to `true` if you want to get the list of vacation rentals instead of hotels default value: `false` amenities: type: array items: type: string description: >- *hotel amenities* optional field you can use this field to specify different hotel amenities example: ` [ "free_parking", "pets_allowed" ]` possible values: `"air_conditioning","all_inclusive_available","bar","free_breakfast","fitness_center","kid_friendly","free_parking","pets_allowed","pool","restaurant","room_service","spa","free_wifi","parking","indoor_pool","outdoor_pool","wheelchair_accessible","beach_access"` tag: type: string description: >- *user-defined task identifier* optional field *the character limit is 255* you can use this parameter to identify the task and match it with the result you will find the specified `tag` value in the `data` object of the response required: - location_name - location_code - location_coordinate - language_name - language_code responses: '200': description: Successful response content: application/json: schema: type: object properties: version: type: string description: '*the current version of the API*' version.status_code: type: integer description: >- *general status code* you can find the full list of the response codes [here](https://docs.dataforseo.com/v3/appendix/errors.md) **Note:** we strongly recommend designing a necessary system for handling related exceptional or error conditions version.status_message: type: string description: >- *general informational message* you can find the full list of general informational messages [here](https://docs.dataforseo.com/v3/appendix/errors.md) version.time: type: string description: '*execution time, seconds*' version.cost: type: number description: '*total tasks cost, USD*' version.tasks_count: type: integer description: '*the number of tasks in the **`tasks`**array*' version.tasks_error: type: integer description: >- *the number of tasks in the **`tasks`** array returned with an error* tasks: type: array items: type: string description: '*array of tasks*' tasks.id: type: string description: >- *unique task identifier in our system* in the [Universally unique identifier (UUID)](https://en.wikipedia.org/wiki/Universally_unique_identifier) format tasks.status_code: type: integer description: >- *status code of the task* generated by DataForSEO; can be within the following range: 10000-60000 tasks.status_message: type: string description: '*informational message of the task*' tasks.time: type: string description: '*execution time, seconds*' tasks.cost: type: number description: '*cost of the task, USD*' tasks.result_count: type: integer description: '*number of elements in the `result` array*' tasks.path: type: array items: type: string description: '*URL path*' tasks.data: type: object description: >- *contains the same parameters that you specified in the POST request* result: type: array items: type: string description: '*array of results*' result.keyword: type: string description: >- *keyword received in a POST array* **keyword is returned with decoded %## (plus character ‘+’ will be decoded to a space character)** result.location_code: type: integer description: '*location code in a POST array*' result.language_code: type: string description: '*language code in a POST array*' result.check_url: type: string description: >- *direct URL to search engine results* you can use it to make sure that we provided accurate results result.datetime: type: string description: >- *date and time when the result was received* in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: `2019-11-15 12:57:46 +00:00` result.items_count: type: integer description: '*item types* the number of items in the `items` array' items: type: array items: type: string description: >- *encountered item types* types of search engine results encountered in the `items` array; possible item types: `hotel_search_item` items.type: type: string description: '*type of element = **‘hotel\_search\_item’***' items.hotel_identifier: type: string description: >- *unique identifier of a hotel entity in Google search* example: `CgoI-KWyzenM_MV3EAE` items.title: type: string description: '*title of the hotel*' items.stars: type: integer description: >- *hotel class rating* class rating that ranges between 1-5 stars items.is_paid: type: boolean description: >- *indicates a paid hotel listing* if `true`, related `hotel_search_item` is a paid ad if `false`, related `hotel_search_item` is an organic hotel listing items.location: type: object description: '*GPS coordinates of the hotel’s location*' items.latitude: type: number description: >- *latitude coordinate of the hotel in google maps* example: `"latitude": 51.584091` items.longitude: type: number description: >- *longitude coordinate of the hotel in google maps* example: `"longitude": -0.31365919999999997` items.reviews: type: object description: '*hotel reviews and rating information*' items.value: type: number description: '*the average rating based on all reviews*' items.votes_count: type: integer description: '*the number of votes*' items.mentions: type: array items: type: string description: >- *hotel mentions* **note:** this field always equals `null`; use it to facilitate integration and ensure interoperability with the [Hotel Info](https://docs.dataforseo.com/v3/business_data/google/hotel_info/live/advanced.md) endpoint items.rating_distribution: type: object description: >- *rating distribution by votes* **note:** this field always equals `null`; use it to facilitate integration and ensure interoperability with the [Hotel Info](https://docs.dataforseo.com/v3/business_data/google/hotel_info/live/advanced.md) endpoint items.other_sites_reviews: type: array items: type: string description: >- *reviews on third-party sites* **note:** this field always equals `null`; use it to facilitate integration and ensure interoperability with the [Hotel Info](https://docs.dataforseo.com/v3/business_data/google/hotel_info/live/advanced.md) endpoint items.overview_images: type: array items: type: string description: '*featured images for a hotel*' items.prices: type: object description: '*hotel price*' items.price: type: integer description: '*price per night*' items.price_without_discount: type: integer description: '*full price per night without a discount applied*' items.currency: type: string description: >- *price currency* `USD` is applied by default, unless specified in the POST array items.discount_text: type: string description: '*text about a discount applied*' items.check_in: type: string description: >- *check-in date and time* in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: `2019-11-15 12:57:46 +00:00` items.check_out: type: string description: >- *check-out date and time* in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: `2019-11-15 12:57:46 +00:00` items.visitors: type: integer description: '*number of hotel visitors for this price*' items.items: type: array items: type: string description: >- *array of items* **note:** this field always equals `null`; use it to facilitate integration and ensure interoperability with the [Hotel Info](https://docs.dataforseo.com/v3/business_data/google/hotel_info/live/advanced.md) endpoint '400': description: Bad request '401': description: Unauthorized '429': description: Rate limit exceeded '500': description: Internal server error components: securitySchemes: BearerAuth: type: http scheme: bearer ````