Felo API PlatformFelo API Platform

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