数据 API / DataForSEO / Business Data
Get Advanced Google Hotel Info Results by id
Retrieves a queued hotel listing by id, parsed. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200. ⚠️ The response size was fixed by the depth or limit set at submit time and cannot be narrowed here; if it is too large, resubmit smaller rather than paging.
参数
路径
idstring必填DataForSEO task ID.
请求示例
curl -X GET "https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/hotel_info/task_get/advanced/{id}" \
-H "Authorization: Bearer $FELO_API_KEY"响应
响应字段
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
tasksarray*tasks_errorinteger可选*the number of tasks in the
tasksarray 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
resultarraypathstring[]可选URL path
dataobject可选contains the same parameters that you specified in the POST request
resultstring[]可选array of results
hotel_identifierstring可选unique hotel identifier this field will contain the
hotel_identifierparameter; example:CgoI-KWyzenM_MV3EAElocation_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:00titlestring可选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_priceamenitystring可选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
amenityis available in the hotelpopular_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.4806397longitudenumber可选hotel longitude latitude coordinates of the hotel’s location example:
-106.0512973location_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 10Max5– value in the range from 1 to 5votes_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,Max5rating_maxinteger可选maximal value of the rating the maximal value for the
rating_typeoverview_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:
USDdiscount_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:00check_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:00visitorsinteger可选number of visitors
typestring可选*type = ‘hotel\_info\_price\_offer’*
is_paidboolean可选indicates a paid booking link if
true, relatedhotel_info_priceitem is a hotel ad iffalse, relatedhotel_info_priceitem is a free booking linkfree_cancellation_untilstring可选date until free cancellation is available in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” equals
nullif free cancellation is not available for the selected datesoffersstring[]可选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:00check_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