Skip to main content
GET
Find places to stay
Find properties for a destination and stay of 1–30 nights. Check-in must be today or later in UTC. Use a returned id for hotel details and rates or guest reviews. Only offer these actions when an ID is present. Star class and guest rating are separate fields.

Example stay

Generate future dates with Python 3, then search:

Authorizations

Authorization
string
header
required

Public API key: Authorization: Bearer san_....

Query Parameters

page
number

1 based, up to 5.

Example:

1

country
string

ISO 3166-1 alpha-2. Defaults to us.

Example:

"us"

currency
string

ISO 4217. Defaults to the currency of country.

Example:

"USD"

stars
string

Comma list of star classes, 1 to 5.

Example:

"4,5"

check_out
string
required

YYYY-MM-DD. 1 to 30 nights after check_in.

Example:

"2026-10-19"

check_in
string
required

YYYY-MM-DD. Not in the past.

Example:

"2026-10-15"

query
string
required

The destination: a city, a neighbourhood or a landmark.

Example:

"Tokyo"

Response

id
string<uuid>
required

Id of this request. Quote it when reporting a problem.

took_ms
number
required

How long the request took, in milliseconds.

Example:

1420

request
object
required

The parameters as accepted, after defaults and normalization. What the request actually ran with.

Example:
next_page
number | null
required

The next page to ask for, or null when there is no further page. Never a page this endpoint would reject.

Example:

2

results
object[]
required
total_results
number

Total matches reported for the search.

Example:

15000

currency
string

ISO 4217 code the prices are quoted in.

Example:

"USD"