Get Google Hotel Searches Results by id

DataForSEO task ID.

the current version of the API

general status code you can find the full list of the response codes here Note: we strongly recommend designing a necessary system for handling related exceptional or error conditions

general informational message you can find the full list of general informational messages here

execution time, seconds

*total tasks cost, USD*

*the number of tasks in the tasks array*

*the number of tasks in the tasks array that were returned an error*

array of tasks

task identifier unique task identifier in our system in the UUID format

status code of the task generated by DataForSEO; can be within the following range: 10000-60000 you can find the full list of the response codes here

informational message of the task you can find the full list of general informational messages here

execution time, seconds

cost of the task, USD

number of elements in the result array

URL path

contains the same parameters that you specified in the POST request

array of results

keyword received in a POST array keyword is returned with decoded %## (plus character ‘+’ will be decoded to a space character); in order to obtain accurate search results, the location name is appended to the keyword automatically

location code in a POST array

language code in a POST array

direct URL to search engine results you can use it to make sure that we provided accurate results

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

item types the number of items in the items array

encountered item types types of search engine results encountered in the items array; possible item types: hotel_search_item

*type of element = ‘hotel\_search\_item’*

unique identifier of a hotel entity in Google search example: CgoI-KWyzenM_MV3EAE

title of the hotel

hotel class rating class rating that ranges between 1-5 stars

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

GPS coordinates of the hotel’s location

latitude coordinate of the hotel in google maps example: "latitude": 51.584091

longitude coordinate of the hotel in google maps example: "longitude": -0.31365919999999997

hotel reviews and rating information

the average rating based on all reviews

the number of votes

hotel mentions note: this field always equals null; use it to facilitate integration and ensure interoperability with the Hotel Info endpoint

rating distribution by votes note: this field always equals null; use it to facilitate integration and ensure interoperability with the Hotel Info endpoint

reviews on third-party sites note: this field always equals null; use it to facilitate integration and ensure interoperability with the Hotel Info endpoint

featured images for a hotel

hotel price

price per night

full price per night without a discount applied

price currency USD is applied by default, unless specified in the POST array

text about a discount applied

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

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

number of hotel visitors for this price

array of items note: this field always equals null; use it to facilitate integration and ensure interoperability with the Hotel Info endpoint