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