Skip to main content
POST
/hopper/hotels/search

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
check_in
string<date>
required
check_out
string<date>
required
count
integer
required
Required range: x >= 1
timeout
integer
default:300
Required range: 20 <= x <= 1500
place_id
string | null
lodging_ids
string[]
adults
integer
default:2
Required range: 1 <= x <= 16
children_ages
integer[]
rooms
integer
default:1
Required range: 1 <= x <= 8
pets
integer
default:0
Required range: 0 <= x <= 8
property_type
enum<string>
default:all
Available options:
all,
hotel,
vacation_rental
star_ratings
integer[]
price_min
number | null
Required range: x >= 0
price_max
number | null
Required range: x >= 0
min_guest_score
number | null
Required range: 0 <= x <= 1
free_cancellation
boolean
default:false
sort
enum<string>
default:recommended
Available options:
recommended,
price_low,
price_high,
rating

Response

Successful Response

@type
string
default:HopperHotelOffer
hotel
object | null
nightly_price
number | null
total_price
number | null
original_nightly_price
number | null
original_total_price
number | null
discount_percentage
number | null
currency
string | null
meal_plan
string | null
free_cancellation
boolean | null
pay_now
boolean | null
pay_at_check_in
boolean | null
is_preferred
boolean | null
review_score
number | null
review_count
integer | null
shop_token
string | null