v0.1.0-beta

OpenAPI 3.1.0

Live Google Hotel Info Advanced

Felo API Support

MIT

サーバー

https://openapi.felo.ai

クライアントライブラリ

Shell Curl

DataForSEO

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

DataForSEO 操作

post/v1/beta/dataforseo/business_data/google/hotel_info/live/advanced

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.

リクエストボディ

必須

application/json

型: array object[]
- 型: object
  hotel_identifier
  型: string
  必須
  
  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
  
  adults
  型: integer
  
  number of adults optional field if you don’t specify this field, two adults will be used by default example: 1
  
  check_in
  型: string
  
  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_out
  型: string
  
  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"
  
  children
  型: array integer[]
  
  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]
  
  currency
  型: string
  
  currency optional field example: "USD"
  
  language_code
  型: string
  
  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
  
  language_name
  型: string
  
  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
  
  load_prices_by_dates
  型: boolean
  
  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
  
  location_code
  型: integer
  
  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_coordinate
  型: string
  
  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
  
  location_name
  型: string
  
  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
  
  prices_date_range
  型: string
  
  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
  
  prices_end_date
  型: string
  
  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_start_date
  型: string
  
  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
  
  tag
  型: string
  
  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
  
  空のオブジェクト
  空のオブジェクト

レスポンス

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

identifier received in a POST array this field will contain the hotel_identifier parameter specified when setting a task; 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.

post/v1/beta/dataforseo/business_data/google/hotel_info/live/advanced

curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/hotel_info/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {},
  {}
]'

スキーマを表示

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

Live Google Hotel Info Advanced

認証Required

DataForSEO

Live Google Hotel Info Advanced