Data API / DataForSEO / Business Data

Live Google Hotel Info Advanced

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.

Параметры

Параметров пути, запроса и заголовков нет.

Тело запроса

hotel_identifierstringОбязательный
unique hotel identifier required field unique identifier of a hotel entity in Google search; you can obtain the value by making a request to Advanced Google SERP API (enclosed in the hotels element of the response), or the Hotel Searches endpoint of Business Data API example: ChYIq6SB--i6p6cpGgovbS8wN2s5ODZfEAE
location_namestringНеобязательный
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
location_codeintegerНеобязательный
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_coordinatestringНеобязательный
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_namestringНеобязательный
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_codestringНеобязательный
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
check_instringНеобязательный
check-in date optional field if you don’t specify this field, tomorrow’s date will be used by default; the value must not be earlier than today’s date date format: "yyyy-mm-dd" example: "2019-01-15"
check_outstringНеобязательный
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; 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 date format: "yyyy-mm-dd" example: "2019-01-15"
currencystringНеобязательный
currency optional field example: "USD"
adultsintegerНеобязательный
number of adults optional field if you don’t specify this field, two adults will be used by default example: 1
childreninteger[]Необязательный
number and age of children optional field if you don’t specify this field, no children will be included in the search; set the following value if you want to include one 14-years-old child: [14] set the following value if you want to include one 13-years-old child and one 8-years-old child: [13,8]
load_prices_by_datesbooleanНеобязательный
load hotel stay prices by dates optional field if you specify this parameter with true, the response will include the prices_by_dates array with hotel stay prices divided by dates if you use this parameter, you will be charged double the base price for a request
prices_start_datestringНеобязательный
start date to load prices by dates optional field to use this parameter, you must specify load_prices_by_dates with true if this parameter is not specified, the start date is set to check_in date date format: yyyy-mm-dd example: 2025-05-20
prices_end_datestringНеобязательный
end date to load prices by dates optional field to use this parameter, you must specify load_prices_by_dates with true if this parameter is not specified, you will get prices by date for the month date format: yyyy-mm-dd example: 2025-05-21
prices_date_rangestringНеобязательный
predefined period for retrieving daily price data optional field to use this parameter, you must specify load_prices_by_dates with true if the prices_start_date is not specified, the start date is set to check_in date possible values: month, three_months, six_months, year default value: month
tagstringНеобязательный
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

Пример запроса

curl -X POST "https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/hotel_info/live/advanced" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "hotel_identifier": "<string>",
  "location_name": "<string>",
  "location_code": 0,
  "location_coordinate": "<string>",
  "language_name": "<string>",
  "language_code": "<string>",
  "check_in": "<string>",
  "check_out": "<string>"
}'

Ответ

Поля ответа

versionstringНеобязательный
the current version of the API
status_codeintegerНеобязательный
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
status_messagestringНеобязательный
general informational message you can find the full list of general informational messages here
timestringНеобязательный
execution time, seconds
costnumberНеобязательный
*total tasks cost, USD*
tasks_countintegerНеобязательный
*the number of tasks in the tasks array*
tasks_errorintegerНеобязательный
*the number of tasks in the tasks array that were returned an error*
tasksstring[]Необязательный
array of tasks
idstringНеобязательный
task identifier unique task identifier in our system in the UUID format
status_codeintegerНеобязательный
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
status_messagestringНеобязательный
informational message of the task you can find the full list of general informational messages here
timestringНеобязательный
execution time, seconds
costnumberНеобязательный
cost of the task, USD
result_countintegerНеобязательный
number of elements in the result array
pathstring[]Необязательный
URL path
dataobjectНеобязательный
contains the same parameters that you specified in the POST request
resultstring[]Необязательный
array of results
hotel_identifierstringНеобязательный
identifier received in a POST array this field will contain the hotel_identifier parameter specified when setting a task; example: CgoI-KWyzenM_MV3EAE
location_codeintegerНеобязательный
location code in a POST array
language_codestringНеобязательный
language code in a POST array
check_urlstringНеобязательный
direct URL to search engine results you can use it to make sure that we provided accurate results
datetimestringНеобязательный
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
titlestringНеобязательный
title of the price offer
starsintegerНеобязательный
hotel class rating class rating that ranges between 1-5 stars and displayed after review ratings in hotel summary
stars_descriptionstringНеобязательный
hotel class rating class rating that ranges between 1-5 stars and displayed after review ratings in the hotel summary
addressstringНеобязательный
hotel address physical address of the hotel
phonestringНеобязательный
hotel phone number contact phone number of the hotel
aboutobjectНеобязательный
information about the hotel
descriptionstringНеобязательный
description of the hotel the description of the hotel entity for which the results are collected
sub_descriptionsstring[]Необязательный
additional description of the hotel details about the hotel provided in addition to the description
check_in_timeobjectНеобязательный
hotel check-in time check-in time indicated in the hotel listing
hourintegerНеобязательный
check-out hour
minuteintegerНеобязательный
check-out minute
check_out_timeobjectНеобязательный
hotel check-out time check-out time indicated in the hotel listing
full_addressstringНеобязательный
full address of the hotel address of the hotel indicated in the standardised format
domainstringНеобязательный
third-party domain domain of the third-party website page with pricing information
urlstringНеобязательный
url of the price offer URL to the page of the website where price offer appears
amenitiesstring[]Необязательный
hotel amenities information about hotel amenities
categorystringНеобязательный
standardised category of the ammenity
category_labelstringНеобязательный
label of the category
itemsstring[]Необязательный
array of items array containing pricing details from third-party websites; possible item types: hotel_info_price
amenitystringНеобязательный
standardised amenity name
amenity_labelstringНеобязательный
displayed amenity name
hintstringНеобязательный
standardised details about the amenity
hint_labelstringНеобязательный
displayed details about the amenity
is_availablebooleanНеобязательный
indicates whether the amenity is available in the hotel
popular_amenitiesstring[]Необязательный
hotel amenities information about hotel amenities labelled as “popular”
locationobjectНеобязательный
information about the hotel location information about the location where the hotel is located
neighborhoodstringНеобязательный
name of the neighborhood where the hotel is located
neighborhood_descriptionstringНеобязательный
description of the neighborhood where the hotel is located
maps_urlstringНеобязательный
url to the location of the hotel in google maps
overall_scorenumberНеобязательный
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_by_categoriesobjectНеобязательный
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;
overallnumberНеобязательный
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
things_to_donumberНеобязательный
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
restaurantsnumberНеобязательный
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
transitnumberНеобязательный
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
airport_accessnumberНеобязательный
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
latitudenumberНеобязательный
hotel latitude latitude coordinates of the hotel’s location example: 39.4806397
longitudenumberНеобязательный
hotel longitude latitude coordinates of the hotel’s location example: -106.0512973
location_chainstring[]Необязательный
elements of the location chain additional parameters of each element of the location chain
card_idstringНеобязательный
card identifier
feature_idstringНеобязательный
feature identifier learn more about the identifier in this help center article
cidstringНеобязательный
client id learn more about the identifier in this help center article
reviewsobjectНеобязательный
hotel reviews by criteria information about reviews of the hotel entity
valuenumberНеобязательный
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_countintegerНеобязательный
votes count the number of votes enclosed in the review
mentionsstring[]Необязательный
hotel mentions information about hotel reviews by criteria
positive_scorenumberНеобязательный
positive score by criterion
positive_countintegerНеобязательный
count of positive reviews by criterion
negative_countintegerНеобязательный
count of negative reviews by criterion
total_countintegerНеобязательный
count of all reviews by criterion
visible_by_defaultbooleanНеобязательный
element is visible by default indicates whether the review element is visible by default
rating_distributionobjectНеобязательный
rating distribution by votes the distribution of votes across the rating in the range from 1 to 5
5integerНеобязательный
votes for the 5-points rating
4integerНеобязательный
votes for the 4-points rating
3integerНеобязательный
votes for the 3-points rating
2integerНеобязательный
votes for the 2-points rating
1integerНеобязательный
votes for the 1-point rating
other_sites_reviewsstring[]Необязательный
reviews on third-party sites reviews from third-paty sites
review_textstringНеобязательный
review text text of the review
ratingobjectНеобязательный
rating in the review information about the rating enclosed in the review on a third-party site
rating_typestringНеобязательный
rating type the type of rating enclosed in the review possible values: CustomMax, Max5
rating_maxintegerНеобязательный
maximal value of the rating the maximal value for the rating_type
overview_imagesstring[]Необязательный
images displayed in the hotel overview array containing URLs to images displayed in the hotel overview
pricesobjectНеобязательный
pricing details of the hotel entity contains information about the hotel’s prices
priceintegerНеобязательный
price per night the price per night for staying at the hotel on a specific date
price_without_discountintegerНеобязательный
price without discount the price of the stay in the hotel per night, with no discount applied
currencystringНеобязательный
price currency example: USD
discount_textstringНеобязательный
text of the discount
check_instringНеобязательный
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_outstringНеобязательный
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
visitorsintegerНеобязательный
number of visitors
typestringНеобязательный
*type = ‘hotel\_info\_price\_offer’*
is_paidbooleanНеобязательный
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
free_cancellation_untilstringНеобязательный
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
offersstring[]Необязательный
featured price offers
max_visitorsintegerНеобязательный
the maximal number of visitors the maximum number of visitors for which the price offer is valid
offer_imagesstring[]Необязательный
price offer images URLs of the images featured in the price offer
prices_by_datesstring[]Необязательный
array of objects with hotel stay prices by dates
check_in_datestringНеобязательный
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_datestringНеобязательный
check-out date in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2025-05-21 12:00:00 +00:00