데이터 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