Felo API PlatformFelo API Platform

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

Parameters

path

  • idstringRequired

    DataForSEO task ID.

Example request

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"

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

    unique hotel identifier this field will contain the hotel_identifier parameter; 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