数据 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