Hotel Filter
The Hotel Filter API enables you to retrieve hotel search results based on the filter criteria provided in the Hotel Search API's response.
This API returns hotels that match the specified filtration parameters. To get progressive results for a particular session, use the `sessionId` value from the relevant Hotel Search Results API response.
Hotel Filter Request
| Method | URL |
|---|---|
| GET | https://das.hotel.demircode.net/HotelAPI/filterResults |
Hotel Filter Elements
| Element | Format | Description | Required |
|---|---|---|---|
| sessionId | String | Use the session ID returned in the Hotel Search Results API's response. | REQUIRED |
| maxResult | Integer | Specify the number of results you want to receive in the filter search response. | REQUIRED |
| filters | Array | An array of all filtration parameters. | REQUIRED |
| price | Array | An array specifying the minimum and maximum price range. | OPTIONAL |
| rating | String | Pass the rating values ranging from 0 to 5. For example, "0,1,2,3,4,5". | OPTIONAL |
| tripadvisorRating | String | Pass the TripAdvisor rating values ranging from 0 to 5. For example, "0,1,1.5,2,2.5,3,3.5,4,4.5,5". | OPTIONAL |
| hotelName | String | Use the hotel's initial name to search the response. | OPTIONAL |
| faretype | String | Filter results by Refundable/Non-Refundable. | OPTIONAL |
| propertyType | String | Filter by property type as indicated in the hotel search response. For example, "HOTELS, RESORTS, APARTMENTS". | OPTIONAL |
| facility | String | Filter by facility as indicated in the hotel search response. For example, "WLAN access, Room Service, Laundry Service". | OPTIONAL |
| sorting | String | Sort results by rating, price, distance from the center, or alphabetically. For example, "price-low-high", "price-high-low", "rating-low-high", "rating-high-low", "alpha-A-Z", "alpha-Z-A", "distance-low-high", "distance-high-low". | OPTIONAL |
| locality | String | Filter by locality or region as indicated in the hotel search response. | OPTIONAL |
Sample Hotel Filter Request
{
"sessionId":"TVRVNE1qSTJNRFkzTUY4ek9EQmZNVEkxTGprNUxqSTBNUzR5TkE9PV8w",
"maxResult":20,
"filters":{
"price":{
"min": 100,
"max": 500000
},
"rating":"1,2,3,4,5",
"tripadvisorRating":"1,1.5,2,2.5,3,3.5,4.5,5",
"hotelName":"Hotel",
"faretype": "Non-Refundable",
"propertyType":"HOTELS",
"facility":"Internet access,Air conditioning",
"sorting": "price-low-high",
"locality":"region_name1,region_name2"
}
}
Sample Hotel Filter Response
{
"status": {
"sessionId": "TVRVNE1qSTJNVFE1TWw4ME9ESmZNVEkxTGprNUxqSTBNUzR5TkE9PV8w",
"moreResults": true,
"nextToken": "MjE=",
"filterKey": "MCwxLDIsMyw0LDVfMCwxLDEuNSwyLDIuNSwzLDMuNSw0LDQuNSw1XzEwMF81MDAwMDBfYWxsX3ByaWNlLWxvdy1oaWdoXzIwX19fXw=="
},
"itineraries": [
{
"hotelId": "882885",
"twxHotelId": "456392",
"productId": "trx101",
"tokenId": "TdjpJ7ikRnHSyZNth3ob",
"hotelName": "DELMON PALACE",
"city": "Dubai",
"locality": "Riqqah al Butayn",
"distanceValue": 1.8400000000000000799360577730112709105014801025390625,
"distanceUnit": "KM",
"country": "United Arab Emirates",
"address": "Al Rigga Road, Al Rigga RoadDeiraDubai, Dubai, PO21969, United Arab Emirates, United Arab Emirates",
"latitude": "25.2609897",
"longitude": "55.3226453",
"hotelRating": 4,
"total": 1834.23000000000001818989403545856475830078125,
"currency": "INR",
"fareType": "Non-Refundable",
"propertyType": "HOTELS",
"postalCode": "0",
"phone": "971-422-22333",
"email": "reservation@delmonpalace.ae",
"thumbNailUrl": "https://i.travelapi.com/hotels/15000000/14590000/14581300/14581244/0fb39be1_t.jpg",
"facilities": [
"24-hour reception",
"Lift",
"Cafe",
"Shops",
"Bar",
"Nightclub",
"Theatre",
"Casino",
"Games room",
"Restaurant",
"Conference Room",
"Internet access",
"WLAN access",
"Laundry Service",
"Car Park",
"TV Room"
],
"tripAdvisorRating": "2.0",
"tripAdvisorReview": "54"
},
{
"hotelId": "651665",
"twxHotelId": "120436",
"productId": "trx101",
"tokenId": "vkPeJioqgX4sMnUtYhIu",
"hotelName": "Fortune Pearl Hotel Deira",
"city": "Dubai",
"locality": "Al Murar al Jadid",
"distanceValue": 1.12000000000000010658141036401502788066864013671875,
"distanceUnit": "KM",
"country": "United Arab Emirates",
"address": "Omar Bin Khattab Road, After Naif Signal and behind Al BarahaP.O. Box 98661Deira, Dubai, 95661, Unit",
"latitude": "25.278530999999997",
"longitude": "55.313779",
"hotelRating": 3,
"total": 2095.11000000000012732925824820995330810546875,
"currency": "INR",
"fareType": "Non-Refundable",
"propertyType": "HOTELS",
"postalCode": "95661",
"phone": "+97142725888",
"email": "crs@fortune-hotels.net",
"thumbNailUrl": "https://assets.cosmos-data.com/thumbnails/large/77/32b585909b133cb041cf37dd66ba73a7/488809.jpg",
"facilities": [
"Lift",
"Cafe",
"Bar",
"Nightclub",
"Restaurant",
"Conference Room",
"Internet access",
"WLAN access",
"Room Service",
"Laundry Service",
"Medical Assistance",
"Car Park"
],
"tripAdvisorRating": "3.0",
"tripAdvisorReview": "83"
}
]
}
Otel Filtresi
Otel Filtresi API'si, Otel Arama API'sinin yanıtında sağlanan filtre kriterlerine göre otel arama sonuçlarını almanızı sağlar.
Bu API, belirtilen filtreleme parametrelerine uyan otelleri döndürür. Belirli bir oturum için ilerleyici sonuçlar almak için, ilgili Otel Arama Sonuçları API yanıtındaki `sessionId` değerini kullanın.
Otel Filtresi İsteği
| Yöntem | URL |
|---|---|
| GET | https://das.hotel.demircode.net/HotelAPI/filterResults |
Otel Filtresi Elemanları
| Eleman | Format | Açıklama | Gerekli |
|---|---|---|---|
| sessionId | String | Otel Arama Sonuçları API'sinin yanıtında döndürülen oturum kimliğini kullanın. | GEREKLİ |
| maxResult | Integer | Filtre arama yanıtında almak istediğiniz sonuç sayısını belirtin. | GEREKLİ |
| filters | Array | Tüm filtreleme parametrelerini içeren bir dizi. | GEREKLİ |
| price | Array | Minimum ve maksimum fiyat aralığını belirten bir dizi. | OPSİYONEL |
| rating | String | 0 ile 5 arasında değişen derecelendirme değerlerini girin. Örneğin, "0,1,2,3,4,5". | OPSİYONEL |
| tripadvisorRating | String | TripAdvisor derecelendirme değerlerini 0 ile 5 arasında girin. Örneğin, "0,1,1.5,2,2.5,3,3.5,4,4.5,5". | OPSİYONEL |
| hotelName | String | Yanıttan otel adını aramak için otelin baş harfini kullanın | OPSİYONEL |
| faretype | String | Sonuçları İade Edilebilir/İade Edilemez olarak filtreleyin. | OPSİYONEL |
| propertyType | String | Otel arama yanıtında belirtilen mülk türüne göre filtreleyin. Örneğin, "OTELLER, TATİL KÖYLERİ, APARTMANLAR". | OPSİYONEL |
| facility | String | Otel arama yanıtında belirtilen olanaklara göre filtreleyin. Örneğin, "WLAN erişimi, Oda Servisi, Çamaşırhane Servisi". | OPSİYONEL |
| sorting | String | Sonuçları derecelendirme, fiyat, şehir merkezine uzaklık veya alfabetik sıraya göre sıralayın. Örneğin, "fiyat-düşük-yüksek", "fiyat-yüksek-düşük", "derecelendirme-düşük-yüksek", "derecelendirme-yüksek-düşük", "alfabetik-A-Z", "alfabetik-Z-A", "mesafe-düşük-yüksek", "mesafe-yüksek-düşük". | OPSİYONEL |
| locality | String | Otel arama yanıtında belirtilen yerel bölgeye veya bölgeye göre filtreleyin | OPSİYONEL |
Örnek Otel Filtre Talebi
{
"sessionId":"TVRVNE1qSTJNRFkzTUY4ek9EQmZNVEkxTGprNUxqSTBNUzR5TkE9PV8w",
"maxResult":20,
"filters":{
"price":{
"min": 100,
"max": 500000
},
"rating":"1,2,3,4,5",
"tripadvisorRating":"1,1.5,2,2.5,3,3.5,4.5,5",
"hotelName":"Hotel",
"faretype": "Non-Refundable",
"propertyType":"HOTELS",
"facility":"Internet access,Air conditioning",
"sorting": "price-low-high",
"locality":"region_name1,region_name2"
}
}
Örnek Otel Filtresi Yanıtı
{
"status": {
"sessionId": "TVRVNE1qSTJNVFE1TWw4ME9ESmZNVEkxTGprNUxqSTBNUzR5TkE9PV8w",
"moreResults": true,
"nextToken": "MjE=",
"filterKey": "MCwxLDIsMyw0LDVfMCwxLDEuNSwyLDIuNSwzLDMuNSw0LDQuNSw1XzEwMF81MDAwMDBfYWxsX3ByaWNlLWxvdy1oaWdoXzIwX19fXw=="
},
"itineraries": [
{
"hotelId": "882885",
"twxHotelId": "456392",
"productId": "trx101",
"tokenId": "TdjpJ7ikRnHSyZNth3ob",
"hotelName": "DELMON PALACE",
"city": "Dubai",
"locality": "Riqqah al Butayn",
"distanceValue": 1.8400000000000000799360577730112709105014801025390625,
"distanceUnit": "KM",
"country": "United Arab Emirates",
"address": "Al Rigga Road, Al Rigga RoadDeiraDubai, Dubai, PO21969, United Arab Emirates, United Arab Emirates",
"latitude": "25.2609897",
"longitude": "55.3226453",
"hotelRating": 4,
"total": 1834.23000000000001818989403545856475830078125,
"currency": "INR",
"fareType": "Non-Refundable",
"propertyType": "HOTELS",
"postalCode": "0",
"phone": "971-422-22333",
"email": "reservation@delmonpalace.ae",
"thumbNailUrl": "https://i.travelapi.com/hotels/15000000/14590000/14581300/14581244/0fb39be1_t.jpg",
"facilities": [
"24-hour reception",
"Lift",
"Cafe",
"Shops",
"Bar",
"Nightclub",
"Theatre",
"Casino",
"Games room",
"Restaurant",
"Conference Room",
"Internet access",
"WLAN access",
"Laundry Service",
"Car Park",
"TV Room"
],
"tripAdvisorRating": "2.0",
"tripAdvisorReview": "54"
},
{
"hotelId": "651665",
"twxHotelId": "120436",
"productId": "trx101",
"tokenId": "vkPeJioqgX4sMnUtYhIu",
"hotelName": "Fortune Pearl Hotel Deira",
"city": "Dubai",
"locality": "Al Murar al Jadid",
"distanceValue": 1.12000000000000010658141036401502788066864013671875,
"distanceUnit": "KM",
"country": "United Arab Emirates",
"address": "Omar Bin Khattab Road, After Naif Signal and behind Al BarahaP.O. Box 98661Deira, Dubai, 95661, Unit",
"latitude": "25.278530999999997",
"longitude": "55.313779",
"hotelRating": 3,
"total": 2095.11000000000012732925824820995330810546875,
"currency": "INR",
"fareType": "Non-Refundable",
"propertyType": "HOTELS",
"postalCode": "95661",
"phone": "+97142725888",
"email": "crs@fortune-hotels.net",
"thumbNailUrl": "https://assets.cosmos-data.com/thumbnails/large/77/32b585909b133cb041cf37dd66ba73a7/488809.jpg",
"facilities": [
"Lift",
"Cafe",
"Bar",
"Nightclub",
"Restaurant",
"Conference Room",
"Internet access",
"WLAN access",
"Room Service",
"Laundry Service",
"Medical Assistance",
"Car Park"
],
"tripAdvisorRating": "3.0",
"tripAdvisorReview": "83"
}
]
}
