資料 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