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