Get Hotel Filters

Retrieve available search facets and counts for a place, city, or hotel’s city.

GET /hotels/filters

curl "$UNIFYSTAYS_BASE_URL/hotels/filters?city_id=136711" \
  -H "x-api-key: $UNIFYSTAYS_API_KEY" \
  -H "language: en"

200

{
  "success": true,
  "message": "Filters fetched successfully",
  "data": {
    "city_id": 101,
    "place_id": 2930267,
    "total_hotels": 4021,
    "stars": [
      {
        "value": 5,
        "label": "Hotel",
        "count": 342
      }
    ],
    "price_range": {
      "min_usd_cents": 2000,
      "max_usd_cents": 120000
    },
    "property_types": [
      {
        "value": 5,
        "label": "Hotel",
        "count": 342
      }
    ],
    "chains": [
      {
        "value": 5,
        "label": "Hotel",
        "count": 342
      }
    ],
    "facilities": [
      {
        "value": 5,
        "label": "Hotel",
        "count": 342
      }
    ],
    "cached_until": "2026-04-18T00:00:00.000Z"
  }
}

Use this endpoint to build a filter drawer before a hotel search. It returns only the facet values and counts that are relevant to one selected destination: star ratings, price range, property types, hotel chains, and facilities.

Pass exactly one of place_id, city_id, or hotel_id. The API caches the resulting destination facets for 24 hours and returns cached_until in the response.

Request Example

curl "$UNIFYSTAYS_BASE_URL/hotels/filters?city_id=136711" \
  -H "x-api-key: $UNIFYSTAYS_API_KEY" \
  -H "language: en"

Apply the Facets to Search

Use values from the response as inputs to Search Hotels:

Facet response	Search request field
stars	star_ratings
price_range	price_min_usd_cents and price_max_usd_cents
property_types	property_types
chains	chain_ids
facilities	facility_ids

For a place_id, counts cover the full place subtree. For a hotel_id, Unifystays resolves the hotel’s city so a single-hotel result still has a useful filter set.

Facets describe the destination catalogue, not live availability. Apply them to hotel search, then use fresh room options and prebook before checkout.

The OpenAPI section below contains every parameter, facet field, and response schema.

Authorizations

x-api-key · string · header · required

Environment-specific API key created in the Unifystays portal

Headers

Query Parameters

city_id · number

City ID from destination autocomplete. Required if place_id/hotel_id not supplied.

Example:

101

place_id · number

Place ID from destination autocomplete (type=place). Facets cover every hotel in the place subtree (e.g. all of Bali). Takes precedence over city_id/hotel_id.

Example:

2930267

hotel_id · string

Hotel ID (bigint as string). Required if city_id not supplied. Server resolves the hotel's city and returns facets for that city.

Example:

"1892345"

Response

200

application/json

success · boolean · required

Example:

true

message · string · required

Example:

"Filters fetched successfully"

data · object · required

Show child attributes