Felo API PlatformFelo API Platform

Data 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.

Parameters

No path, query, or header parameters.

Request body

  • hotel_identifierstringRequired

    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_namestringOptional

    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_codeintegerOptional

    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_coordinatestringOptional

    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_namestringOptional

    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_codestringOptional

    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_instringOptional

    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_outstringOptional

    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"

  • currencystringOptional

    currency optional field example: "USD"

  • adultsintegerOptional

    number of adults optional field if you don’t specify this field, two adults will be used by default example: 1

  • childreninteger[]Optional

    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_datesbooleanOptional

    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_datestringOptional

    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_datestringOptional

    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_rangestringOptional

    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

  • tagstringOptional

    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

Example request

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>"
}'

Response

Response fields

  • versionstringOptional

    the current version of the API

  • status_codeintegerOptional

    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_messagestringOptional

    general informational message you can find the full list of general informational messages here

  • timestringOptional

    execution time, seconds

  • costnumberOptional

    *total tasks cost, USD*

  • tasks_countintegerOptional

    *the number of tasks in the tasks array*

  • tasks_errorintegerOptional

    *the number of tasks in the tasks array that were returned an error*

  • tasksstring[]Optional

    array of tasks

  • idstringOptional

    task identifier unique task identifier in our system in the UUID format

  • status_codeintegerOptional

    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_messagestringOptional

    informational message of the task you can find the full list of general informational messages here

  • timestringOptional

    execution time, seconds

  • costnumberOptional

    cost of the task, USD

  • result_countintegerOptional

    number of elements in the result array

  • pathstring[]Optional

    URL path

  • dataobjectOptional

    contains the same parameters that you specified in the POST request

  • resultstring[]Optional

    array of results

  • hotel_identifierstringOptional

    identifier received in a POST array this field will contain the hotel_identifier parameter specified when setting a task; example: CgoI-KWyzenM_MV3EAE

  • location_codeintegerOptional

    location code in a POST array

  • language_codestringOptional

    language code in a POST array

  • check_urlstringOptional

    direct URL to search engine results you can use it to make sure that we provided accurate results

  • datetimestringOptional

    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

  • titlestringOptional

    title of the price offer

  • starsintegerOptional

    hotel class rating class rating that ranges between 1-5 stars and displayed after review ratings in hotel summary

  • stars_descriptionstringOptional

    hotel class rating class rating that ranges between 1-5 stars and displayed after review ratings in the hotel summary

  • addressstringOptional

    hotel address physical address of the hotel

  • phonestringOptional

    hotel phone number contact phone number of the hotel

  • aboutobjectOptional

    information about the hotel

  • descriptionstringOptional

    description of the hotel the description of the hotel entity for which the results are collected

  • sub_descriptionsstring[]Optional

    additional description of the hotel details about the hotel provided in addition to the description

  • check_in_timeobjectOptional

    hotel check-in time check-in time indicated in the hotel listing

  • hourintegerOptional

    check-out hour

  • minuteintegerOptional

    check-out minute

  • check_out_timeobjectOptional

    hotel check-out time check-out time indicated in the hotel listing

  • full_addressstringOptional

    full address of the hotel address of the hotel indicated in the standardised format

  • domainstringOptional

    third-party domain domain of the third-party website page with pricing information

  • urlstringOptional

    url of the price offer URL to the page of the website where price offer appears

  • amenitiesstring[]Optional

    hotel amenities information about hotel amenities

  • categorystringOptional

    standardised category of the ammenity

  • category_labelstringOptional

    label of the category

  • itemsstring[]Optional

    array of items array containing pricing details from third-party websites; possible item types: hotel_info_price

  • amenitystringOptional

    standardised amenity name

  • amenity_labelstringOptional

    displayed amenity name

  • hintstringOptional

    standardised details about the amenity

  • hint_labelstringOptional

    displayed details about the amenity

  • is_availablebooleanOptional

    indicates whether the amenity is available in the hotel

  • popular_amenitiesstring[]Optional

    hotel amenities information about hotel amenities labelled as “popular”

  • locationobjectOptional

    information about the hotel location information about the location where the hotel is located

  • neighborhoodstringOptional

    name of the neighborhood where the hotel is located

  • neighborhood_descriptionstringOptional

    description of the neighborhood where the hotel is located

  • maps_urlstringOptional

    url to the location of the hotel in google maps

  • overall_scorenumberOptional

    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_categoriesobjectOptional

    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;

  • overallnumberOptional

    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_donumberOptional

    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

  • restaurantsnumberOptional

    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

  • transitnumberOptional

    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_accessnumberOptional

    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

  • latitudenumberOptional

    hotel latitude latitude coordinates of the hotel’s location example: 39.4806397

  • longitudenumberOptional

    hotel longitude latitude coordinates of the hotel’s location example: -106.0512973

  • location_chainstring[]Optional

    elements of the location chain additional parameters of each element of the location chain

  • card_idstringOptional

    card identifier

  • feature_idstringOptional

    feature identifier learn more about the identifier in this help center article

  • cidstringOptional

    client id learn more about the identifier in this help center article

  • reviewsobjectOptional

    hotel reviews by criteria information about reviews of the hotel entity

  • valuenumberOptional

    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_countintegerOptional

    votes count the number of votes enclosed in the review

  • mentionsstring[]Optional

    hotel mentions information about hotel reviews by criteria

  • positive_scorenumberOptional

    positive score by criterion

  • positive_countintegerOptional

    count of positive reviews by criterion

  • negative_countintegerOptional

    count of negative reviews by criterion

  • total_countintegerOptional

    count of all reviews by criterion

  • visible_by_defaultbooleanOptional

    element is visible by default indicates whether the review element is visible by default

  • rating_distributionobjectOptional

    rating distribution by votes the distribution of votes across the rating in the range from 1 to 5

  • 5integerOptional

    votes for the 5-points rating

  • 4integerOptional

    votes for the 4-points rating

  • 3integerOptional

    votes for the 3-points rating

  • 2integerOptional

    votes for the 2-points rating

  • 1integerOptional

    votes for the 1-point rating

  • other_sites_reviewsstring[]Optional

    reviews on third-party sites reviews from third-paty sites

  • review_textstringOptional

    review text text of the review

  • ratingobjectOptional

    rating in the review information about the rating enclosed in the review on a third-party site

  • rating_typestringOptional

    rating type the type of rating enclosed in the review possible values: CustomMax, Max5

  • rating_maxintegerOptional

    maximal value of the rating the maximal value for the rating_type

  • overview_imagesstring[]Optional

    images displayed in the hotel overview array containing URLs to images displayed in the hotel overview

  • pricesobjectOptional

    pricing details of the hotel entity contains information about the hotel’s prices

  • priceintegerOptional

    price per night the price per night for staying at the hotel on a specific date

  • price_without_discountintegerOptional

    price without discount the price of the stay in the hotel per night, with no discount applied

  • currencystringOptional

    price currency example: USD

  • discount_textstringOptional

    text of the discount

  • check_instringOptional

    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_outstringOptional

    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

  • visitorsintegerOptional

    number of visitors

  • typestringOptional

    *type = ‘hotel\_info\_price\_offer’*

  • is_paidbooleanOptional

    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_untilstringOptional

    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[]Optional

    featured price offers

  • max_visitorsintegerOptional

    the maximal number of visitors the maximum number of visitors for which the price offer is valid

  • offer_imagesstring[]Optional

    price offer images URLs of the images featured in the price offer

  • prices_by_datesstring[]Optional

    array of objects with hotel stay prices by dates

  • check_in_datestringOptional

    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_datestringOptional

    check-out date in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2025-05-21 12:00:00 +00:00