curl "$UNIFYSTAYS_BASE_URL/hotels/filters?place_id=2930267" \
-H "x-api-key: $UNIFYSTAYS_API_KEY" \
-H "language: en"
{
"success": true,
"message": "Filters fetched successfully",
"data": {
"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"
}
}Search & hotels
Get Hotel Filters
Retrieve available search facets and counts for a place or hotel’s canonical pricing place.
GET
/
hotels
/
filters
curl "$UNIFYSTAYS_BASE_URL/hotels/filters?place_id=2930267" \
-H "x-api-key: $UNIFYSTAYS_API_KEY" \
-H "language: en"
{
"success": true,
"message": "Filters fetched successfully",
"data": {
"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.
For a
The OpenAPI section below contains every parameter, facet field, and response
schema.
Pass exactly one of
place_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?place_id=2930267" \
-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 |
place_id, counts cover the full place subtree. For a hotel_id,
Unifystays resolves the hotel’s canonical pricing place 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.
Authorizations
Environment-specific API key created in the Unifystays portal
Headers
Hotel API contract version. Missing defaults to v1.
Available options:
1 Query Parameters
Place ID from destination autocomplete (type=place). Facets cover every hotel in the place subtree (e.g. all of Bali). Cannot be combined with hotel_id.
Example:
2930267
Hotel ID (bigint as string). The server resolves the hotel's canonical pricing place and returns facets for that place subtree.
Example:
"1892345"