SEseats

Search

The Search page as an API: for an area and a range of check-in dates, every hotel with an award starting in that range and its cheapest standard and suite rates, cheapest award first. Give the area as a bounding box or as a place name to geocode. Areas are limited to 500 hotels; narrow the box or filter by source for dense cities.

get/search

Request

  • Base URL
    https://rooms.aero/partnerapi
  • URL
    https://rooms.aero/partnerapi/search
  • Auth
    API key in header Partner-Authorization

Query parameters

start_datestring 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.

end_datestring required

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

sw_latnumber

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

sw_lngnumber

South-west corner longitude, -180 to 180.

ne_latnumber

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

ne_lngnumber

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

locationstring

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

nightsinteger

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

sourcestring

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

max_pointsinteger

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

min_cppnumber

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

skipinteger

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

takeinteger

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

Response

200

countinteger

Number of items in this response.

has_moreboolean

Whether another page exists.

more_urlstring

URL of the next page. Omitted on the last page.

Example response

{
  "data": [
    {
      "hotel": {
        "id": "2PPrELk9WcfJaNREWEPXypvhXAD",
        "source": "hyatt",
        "program": "World of Hyatt",
        "name": "Park Hyatt Tokyo",
        "brand": "park",
        "award_category": "7",
        "address": "3-7-1-2 Nishi Shinjuku, Shinjuku-Ku",
        "city": "Tokyo",
        "country": "Japan",
        "latitude": 35.6852,
        "longitude": 139.6891,
        "image_url": "https://assets.hyatt.com/content/dam/hyatt/hyattdam/images/2018/03/02/1141/Park-Hyatt-Tokyo-P011-Exterior.jpg",
        "internal_id": "tyoph",
        "open": true,
        "url": "https://rooms.aero/hyatt/hotel/2PPrELk9WcfJaNREWEPXypvhXAD",
        "lowest_award": 30000,
        "standard_award_availability_percent": 41,
        "standard_award_availability_window_days": 90
      },
      "lowest_award_standard": 25000,
      "lowest_award_suite": 60000,
      "lowest_cash_standard": 90000,
      "currency_code": "USD",
      "standard_date": "2026-11-26",
      "standard_nights": 1,
      "suite_date": "2026-11-21",
      "suite_nights": 1,
      "cpp": 3
    }
  ],
  "count": 2
}

Changes

No recorded changes to this operation across all 1 revision of this API.