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/v1/beta/dataforseo/business_data/google/hotel_info/task_get/advanced/{id}

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.

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'

显示 Schema

{
  "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

身份验证Required

DataForSEO

Get Advanced Google Hotel Info Results by id