Get Advanced Google Hotel Info 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

unique hotel identifier this field will contain the hotel_identifier parameter; example: CgoI-KWyzenM_MV3EAE

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

title of the price offer

hotel class rating class rating that ranges between 1-5 stars and displayed after review ratings in hotel summary

hotel class rating class rating that ranges between 1-5 stars and displayed after review ratings in the hotel summary

hotel address physical address of the hotel

hotel phone number contact phone number of the hotel

information about the hotel

description of the hotel the description of the hotel entity for which the results are collected

additional description of the hotel details about the hotel provided in addition to the description

hotel check-in time check-in time indicated in the hotel listing

check-out hour

check-out minute

hotel check-out time check-out time indicated in the hotel listing

full address of the hotel address of the hotel indicated in the standardised format

third-party domain domain of the third-party website page with pricing information

url of the price offer URL to the page of the website where price offer appears

hotel amenities information about hotel amenities

standardised category of the ammenity

label of the category

array of items array containing pricing details from third-party websites; possible item types: hotel_info_price

standardised amenity name

displayed amenity name

standardised details about the amenity

displayed details about the amenity

indicates whether the amenity is available in the hotel

hotel amenities information about hotel amenities labelled as “popular”

information about the hotel location information about the location where the hotel is located

name of the neighborhood where the hotel is located

description of the neighborhood where the hotel is located

url to the location of the hotel in google maps

overall score of the hotel location indicates the overall score of the hotel’s location in the range from 1 to 5; calculated based on data from the hotel’s proximity to nearby things to do and restaurants, transportation, and airports; note that the criteria are not weighted equally in the overall score

category scores of the hotel location the scores of the hotel’s location tied to the categories that indicate the proximity to nearby things to do, restaurants, transportation, and airports;

overall score of the hotel location indicates the overall score of the hotel’s location in the range from 1 to 5; calculated based on data from the hotel’s proximity to nearby things to do and restaurants, transportation, and airports; note that the criteria are not weighted equally in the overall score

score relative to nearby things to do indicates the score of the hotel’s location in the range from 1 to 5; calculated based on data from the hotel’s proximity to nearby things to do

score relative to nearby restaurants indicates the score of the hotel’s location in the range from 1 to 5; calculated based on data from the hotel’s proximity to nearby restaurants

score relative to nearby transit options indicates the score of the hotel’s location in the range from 1 to 5; calculated based on data from the hotel’s proximity to nearby transit options

score relative to nearby airports indicates the score of the hotel’s location in the range from 1 to 5; calculated based on data from the hotel’s proximity to nearby airports

hotel latitude latitude coordinates of the hotel’s location example: 39.4806397

hotel longitude latitude coordinates of the hotel’s location example: -106.0512973

elements of the location chain additional parameters of each element of the location chain

card identifier

feature identifier learn more about the identifier in this help center article

client id learn more about the identifier in this help center article

hotel reviews by criteria information about reviews of the hotel entity

rating value value of the rating enclosed in the review possible values: CustomMax – value in the range from 1 to 10 Max5 – value in the range from 1 to 5

votes count the number of votes enclosed in the review

hotel mentions information about hotel reviews by criteria

positive score by criterion

count of positive reviews by criterion

count of negative reviews by criterion

count of all reviews by criterion

element is visible by default indicates whether the review element is visible by default

rating distribution by votes the distribution of votes across the rating in the range from 1 to 5

votes for the 5-points rating

votes for the 4-points rating

votes for the 3-points rating

votes for the 2-points rating

votes for the 1-point rating

reviews on third-party sites reviews from third-paty sites

review text text of the review

rating in the review information about the rating enclosed in the review on a third-party site

rating type the type of rating enclosed in the review possible values: CustomMax, Max5

maximal value of the rating the maximal value for the rating_type

images displayed in the hotel overview array containing URLs to images displayed in the hotel overview

pricing details of the hotel entity contains information about the hotel’s prices

price per night the price per night for staying at the hotel on a specific date

price without discount the price of the stay in the hotel per night, with no discount applied

price currency example: USD

text of the discount

check-in date and tine 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 tine in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00

number of visitors

*type = ‘hotel\_info\_price\_offer’*

indicates a paid booking link if true, related hotel_info_price item is a hotel ad if false, related hotel_info_price item is a free booking link

date until free cancellation is available in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” equals null if free cancellation is not available for the selected dates

featured price offers

the maximal number of visitors the maximum number of visitors for which the price offer is valid

price offer images URLs of the images featured in the price offer

array of objects with hotel stay prices by dates

check-in date in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2025-05-20 12:00:00 +00:00

check-out date in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2025-05-21 12:00:00 +00:00