Hermeseus Docs
Legacy docs

Search destinations

Before you search hotels, resolve what the traveller typed into a destination. Place search returns matching cities, districts, and individual hotels, each with a stable id you pass to the availability search.

Search places

GET/v3/HAPI/hotels/places

Requires the hotels:read scope.

Query parameters

NameTypeRequiredDescription
querystringYesWhat the traveller typed, e.g. dubai.
limitintegerNoMax results, 1–100 (default 20).
typestringNoFilter: city, region, country, hotel, landmark, district.
 
curl "https://api.hermeseus.com/v3/HAPI/hotels/places?query=dubai&type=city" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Response

{
  "object": "hotel_place_list",
  "count": 2,
  "data": [
    {
      "id": "1019782831",
      "name": "Dubai",
      "type": "city",
      "country": "United Arab Emirates",
      "coordinates": { "lat": 25.20, "lng": 55.27 }
    },
    {
      "id": "3038948",
      "name": "Dubai Marina",
      "type": "district",
      "country": "United Arab Emirates",
      "coordinates": null
    }
  ]
}
Use the id as the destination. A city place's id is the city_id for availability search; a hotel place's id is the hotel_id.