Search

Find hotels with award availability in an area and date range, with their cheapest rates.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Search is the rooms.aero search page as an API. Give it an area and a range of check-in dates and it returns every hotel there with at least one award starting in that range, along with the cheapest standard and suite rates and the check-in dates they fall on. start_date and end_date bound when a stay begins, not when it ends; add nights (1 to 5) to look for one stay length, or leave it out for all.

Describe the area either as a bounding box (all four of sw_lat, sw_lng, ne_lat, ne_lng; zero is a valid edge, and the box may not cross the antimeridian) or as a location to geocode, such as a city, island or region name. Areas are limited to 500 hotels; for dense cities, narrow the box or add a source filter. Results come cheapest award first and paginate with skip and take like every other list.

Each result embeds the full hotel object, so you can go straight to Get Availability with its hotel.id for the complete calendar.

Query Params
string
required

Earliest check-in date, YYYY-MM-DD. The dates bound when a stay may begin, not when it ends; use nights for the stay length.

string
required

Latest check-in date, YYYY-MM-DD. Must not be before start_date, and the range may not be entirely in the past.

number

South-west corner latitude of the bounding box, -90 to 90. Provide all four corners, or location. Zero is a valid edge.

number

South-west corner longitude, -180 to 180.

number

North-east corner latitude; must be north of sw_lat.

number

North-east corner longitude; must be east of sw_lng. Boxes may not cross the antimeridian; split the search instead.

string

A place to geocode instead of a bounding box, such as "Tokyo" or "Maui". Ignored when a complete bounding box is given.

integer
1 to 5

Only stays of exactly this many nights, 1 to 5. Omit for every stay length.

string

Loyalty program key(s), comma-delimited if multiple, such as "hyatt,hilton". The keys are listed on the Concepts page.

integer

Only hotels with an award at or below this many points.

number

Only hotels whose best award is worth at least this many US cents per point.

integer
Defaults to 0

How many results to skip. Pagination is skip/take: request the next page with skip = skip + take, or follow more_url.

integer
1 to 500
Defaults to 100

Maximum results to return. Must be between 1 and 500.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json