データ 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