Felo API PlatformFelo API Platform
v0.1.0-beta
OpenAPI 3.1.0

Get Advanced Google Hotel Info Results by id

Felo API Support
MIT
Сервер:https://openapi.felo.ai
Клиентские библиотеки
Shell Curl

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Операции

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.

Параметры пути
  • id
    Тип: string
    обязательно

    DataForSEO task ID.

Ответы
  • 200
    Тип: object

    Successful response

    • result
      Тип: array string[]

      array of results

    • result.1
      Тип: integer

      votes for the 1-point rating

    • result.2
      Тип: integer

      votes for the 2-points rating

    • result.3
      Тип: integer

      votes for the 3-points rating

    • result.4
      Тип: integer

      votes for the 4-points rating

    • result.5
      Тип: integer

      votes for the 5-points rating

    • result.about
      Тип: object

      information about the hotel

    • result.address
      Тип: string

      hotel address physical address of the hotel

    • result.airport_access
      Тип: number

      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

    • result.amenities
      Тип: array string[]

      hotel amenities information about hotel amenities

    • result.amenity
      Тип: string

      standardised amenity name

    • result.amenity_label
      Тип: string

      displayed amenity name

    • result.card_id
      Тип: string

      card identifier

    • result.category
      Тип: string

      standardised category of the ammenity

    • result.category_label
      Тип: string

      label of the category

    • result.check_in
      Тип: string

      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

    • result.check_in_date
      Тип: string

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

    • result.check_in_time
      Тип: object

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

    • result.check_out
      Тип: string

      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

    • result.check_out_date
      Тип: string

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

    • result.check_out_time
      Тип: object

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

    • result.check_url
      Тип: string

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

    • result.cid
      Тип: string

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

    • result.currency
      Тип: string

      price currency example: USD

    • result.datetime
      Тип: string

      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

    • result.description
      Тип: string

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

    • result.discount_text
      Тип: string

      text of the discount

    • result.domain
      Тип: string

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

    • result.feature_id
      Тип: string

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

    • result.free_cancellation_until
      Тип: string

      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

    • result.full_address
      Тип: string

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

    • result.hint
      Тип: string

      standardised details about the amenity

    • result.hint_label
      Тип: string

      displayed details about the amenity

    • result.hotel_identifier
      Тип: string

      unique hotel identifier this field will contain the hotel_identifier parameter; example: CgoI-KWyzenM_MV3EAE

    • result.hour
      Тип: integer

      check-out hour

    • result.is_available
      Тип: boolean

      indicates whether the amenity is available in the hotel

    • result.is_paid
      Тип: boolean

      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

    • result.items
      Тип: array string[]

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

    • result.language_code
      Тип: string

      language code in a POST array

    • result.latitude
      Тип: number

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

    • result.location
      Тип: object

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

    • result.location_chain
      Тип: array string[]

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

    • result.location_code
      Тип: integer

      location code in a POST array

    • result.longitude
      Тип: number

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

    • result.maps_url
      Тип: string

      url to the location of the hotel in google maps

    • result.max_visitors
      Тип: integer

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

    • result.mentions
      Тип: array string[]

      hotel mentions information about hotel reviews by criteria

    • result.minute
      Тип: integer

      check-out minute

    • result.negative_count
      Тип: integer

      count of negative reviews by criterion

    • result.neighborhood
      Тип: string

      name of the neighborhood where the hotel is located

    • result.neighborhood_description
      Тип: string

      description of the neighborhood where the hotel is located

    • result.offer_images
      Тип: array string[]

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

    • result.offers
      Тип: array string[]

      featured price offers

    • result.other_sites_reviews
      Тип: array string[]

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

    • result.overall
      Тип: number

      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

    • result.overall_score
      Тип: number

      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

    • result.overview_images
      Тип: array string[]

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

    • result.phone
      Тип: string

      hotel phone number contact phone number of the hotel

    • result.popular_amenities
      Тип: array string[]

      hotel amenities information about hotel amenities labelled as “popular”

    • result.positive_count
      Тип: integer

      count of positive reviews by criterion

    • result.positive_score
      Тип: number

      positive score by criterion

    • result.price
      Тип: integer

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

    • result.price_without_discount
      Тип: integer

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

    • result.prices
      Тип: object

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

    • result.prices_by_dates
      Тип: array string[]

      array of objects with hotel stay prices by dates

    • result.rating
      Тип: object

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

    • result.rating_distribution
      Тип: object

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

    • result.rating_max
      Тип: integer

      maximal value of the rating the maximal value for the rating_type

    • result.rating_type
      Тип: string

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

    • result.restaurants
      Тип: number

      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

    • result.review_text
      Тип: string

      review text text of the review

    • result.reviews
      Тип: object

      hotel reviews by criteria information about reviews of the hotel entity

    • result.score_by_categories
      Тип: object

      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;

    • result.stars
      Тип: integer

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

    • result.stars_description
      Тип: string

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

    • result.sub_descriptions
      Тип: array string[]

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

    • result.things_to_do
      Тип: number

      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

    • result.title
      Тип: string

      title of the price offer

    • result.total_count
      Тип: integer

      count of all reviews by criterion

    • result.transit
      Тип: number

      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

    • result.type
      Тип: string

      type = ‘hotel_info_price_offer’

    • result.url
      Тип: string

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

    • result.value
      Тип: number

      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

    • result.visible_by_default
      Тип: boolean

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

    • result.visitors
      Тип: integer

      number of visitors

    • result.votes_count
      Тип: integer

      votes count the number of votes enclosed in the review

    • tasks
      Тип: array string[]

      array of tasks

    • tasks.cost
      Тип: number

      cost of the task, USD

    • tasks.data
      Тип: object

      contains the same parameters that you specified in the POST request

    • tasks.id
      Тип: string

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

    • tasks.path
      Тип: array string[]

      URL path

    • tasks.result_count
      Тип: integer

      number of elements in the result array

    • tasks.status_code
      Тип: integer

      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

    • tasks.status_message
      Тип: string

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

    • tasks.time
      Тип: string

      execution time, seconds

    • version
      Тип: string

      the current version of the API

    • version.cost
      Тип: number

      total tasks cost, USD

    • version.status_code
      Тип: integer

      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

    • version.status_message
      Тип: string

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

    • version.tasks_count
      Тип: integer

      the number of tasks in the tasks array

    • version.tasks_error
      Тип: integer

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

    • version.time
      Тип: string

      execution time, seconds

    application/json
  • 400

    Bad request

  • 401

    Unauthorized

  • 402

    The request cannot proceed because a billing requirement is not met.

  • 403

    The account is not permitted to perform this operation.

  • 429

    Rate limit exceeded

  • 500

    Internal server error

  • 502

    The service could not complete the request.

  • 503

    The API or billing service is temporarily unavailable.

  • 504

    The service timed out while processing the request.

  • default

    The operation failed. Keep the response request ID when contacting Felo support.

Request Example for get/v1/beta/dataforseo/business_data/google/hotel_info/task_get/advanced/{id}
curl 'https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/hotel_info/task_get/advanced/{id}' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "version": "string",
  "version.status_code": 1,
  "version.status_message": "string",
  "version.time": "string",
  "version.cost": 1,
  "version.tasks_count": 1,
  "version.tasks_error": 1,
  "tasks": [
    "string"
  ],
  "tasks.id": "string",
  "tasks.status_code": 1,
  "tasks.status_message": "string",
  "tasks.time": "string",
  "tasks.cost": 1,
  "tasks.result_count": 1,
  "tasks.path": [
    "string"
  ],
  "tasks.data": {},
  "result": [
    "string"
  ],
  "result.hotel_identifier": "string",
  "result.location_code": 1,
  "result.language_code": "string",
  "result.check_url": "string",
  "result.datetime": "string",
  "result.title": "string",
  "result.stars": 1,
  "result.stars_description": "string",
  "result.address": "string",
  "result.phone": "string",
  "result.about": {},
  "result.description": "string",
  "result.sub_descriptions": [
    "string"
  ],
  "result.check_in_time": {},
  "result.hour": 1,
  "result.minute": 1,
  "result.check_out_time": {},
  "result.full_address": "string",
  "result.domain": "string",
  "result.url": "string",
  "result.amenities": [
    "string"
  ],
  "result.category": "string",
  "result.category_label": "string",
  "result.items": [
    "string"
  ],
  "result.amenity": "string",
  "result.amenity_label": "string",
  "result.hint": "string",
  "result.hint_label": "string",
  "result.is_available": true,
  "result.popular_amenities": [
    "string"
  ],
  "result.location": {},
  "result.neighborhood": "string",
  "result.neighborhood_description": "string",
  "result.maps_url": "string",
  "result.overall_score": 1,
  "result.score_by_categories": {},
  "result.overall": 1,
  "result.things_to_do": 1,
  "result.restaurants": 1,
  "result.transit": 1,
  "result.airport_access": 1,
  "result.latitude": 1,
  "result.longitude": 1,
  "result.location_chain": [
    "string"
  ],
  "result.card_id": "string",
  "result.feature_id": "string",
  "result.cid": "string",
  "result.reviews": {},
  "result.value": 1,
  "result.votes_count": 1,
  "result.mentions": [
    "string"
  ],
  "result.positive_score": 1,
  "result.positive_count": 1,
  "result.negative_count": 1,
  "result.total_count": 1,
  "result.visible_by_default": true,
  "result.rating_distribution": {},
  "result.5": 1,
  "result.4": 1,
  "result.3": 1,
  "result.2": 1,
  "result.1": 1,
  "result.other_sites_reviews": [
    "string"
  ],
  "result.review_text": "string",
  "result.rating": {},
  "result.rating_type": "string",
  "result.rating_max": 1,
  "result.overview_images": [
    "string"
  ],
  "result.prices": {},
  "result.price": 1,
  "result.price_without_discount": 1,
  "result.currency": "string",
  "result.discount_text": "string",
  "result.check_in": "string",
  "result.check_out": "string",
  "result.visitors": 1,
  "result.type": "string",
  "result.is_paid": true,
  "result.free_cancellation_until": "string",
  "result.offers": [
    "string"
  ],
  "result.max_visitors": 1,
  "result.offer_images": [
    "string"
  ],
  "result.prices_by_dates": [
    "string"
  ],
  "result.check_in_date": "string",
  "result.check_out_date": "string"
}

Successful response

Get Advanced Google Hotel Info Results by id