Hotel Search


Hotel Search Sample

Last Update Date 18.07.2019

Request Sample


v1/search/hotels
├── destinations              ───> Array
│   ├── type                     ───> "hotel" (String)
│   └── id                       ───>  Hotel Id (String) 
├── rooms                     ───> Array
│   ├── adults                   ───> Adult counts(Int32)
│   └── childrenAges             ───> Children Age (Int32[]) e.g[2,1] 
├── checkinDate               ───> Checkin Date(DateTime)
├── checkoutDate              ───> Checkout Date(DateTime)
├── currency                  ───> Currency(String) e.g "EUR"
├── customerNationality       ───> Customer Nationality(String) e.g "TR"
├── filterUnavailable         ───> Filter Unavailable(Bool) 
├── withPromotion             ───> Only Promotion Hotel(Bool)
├── IncludeHotelContent       ───> IncludeHotelContent(Bool)
├── language                  ───> Language(String) e.g "tr"
├── timeout                   ───> Second(Int32)
└── isPreSearch               ───> IsPreSearch(Bool) It is recommended to set true on searching multiple hotels or city (If you search for single hotel again when taking details). Faster response because the offers are not stored.

{
    "destinations": [{
        "type": "hotel",
        "id": "100122"
    }],
    "rooms": [{
        "adults": 2,
        "childrenAges": []
    }],
    "checkinDate": "2016-01-01",
    "checkoutDate": "2016-01-04",
    "currency": "EUR",
    "customerNationality": "TR",
    "filterUnavailable": false,
    "withPromotion": false,
    "IncludeHotelContent": false,
    "language": "tr",
    "timeout": 0,
    "isPreSearch": true
}

Response Sample


├── searchId         ───> Search Id(String)
├── expiresOn        ───> Expires On(DateTime)
└── hotels
    ├── id                 ───> Hotel Id(String)
    ├── name               ───> Hotel Name(String)
    ├── description        ───> Hotel Description(String)
    ├── city
    │   ├── id                  ───> City Id(String)
    │   └── name                ───> City Name(String)
    ├── country
    │   ├── id                  ───> Country Id
    │   └── name                ───> Country Name
    ├── stars               ───> Hotel Stars(Double)
    ├── rating              ───> Hotel Rating(Double)
    ├── reviewUrl           ───> Hotel Rating Review Url(String)
    ├── thumbnail           ───> Thumbnail Image(String)
    ├── themes              ───> Hotel Themes Array(String[]) e.g ["Club Result","City Hotel","Historic Hotel"]
    ├── facilities          ───> Hotel Facilities Array(String[]) e.g ["Air conditioning","WLAN access","Room Service"]
    ├── geolocation
    │   ├── longitude            ───> Longitude(Single)
    │   └── latitude             ───> Latitude(Single)
    ├── isFavorite          ───> Hotels Add to Favourites(Bool) (true/false)
    └── offers              ───> Array
        ├── id                   ───> offer Id(String)
        ├── expiresOn            ───> Expires On(DateTime)
        ├── hotelId              ───> Hotel Id(String)
        ├── boardId              ───> Board Id(String)
        ├── board                ───> Board Type(String) e.g "All Inclusive"
        ├── boardCategories      ───> Board Categories(String[]) Array e.g[""All Inclusive""]
        ├── rooms
        │   ├── id                    ───> Room Id(String)
        │   ├── typeId                ───> Room Type Id(String)
        │   ├── type                  ───> Room Type(String) e.g "Standard Room - 1 double bed"
        │   ├── categories            ───> Room Categories(String[]) Array
        │   ├── promotions            ───> Promotions(String[])
        │   ├── travellers            ───> Travellers Array
        │   │   ├── type                   ───> Traveller(String) Type e.g "adult","child"
        │   │   ├── age                    ───> Traveller Age(Int32)
        │   │   └── nationality            ───> Traveller Nationality(String) e.g "TR"
        ├── price
        │   ├── amount                    ───> Amount(Decimal)
        │   └── currency                  ───> Currency(String) e.g "EUR"
        ├── isSpecial          ───> Bool  (true/false)
        └── isAvailable        ───> Bool  (true/false)


{
  "searchId": "b917b3c8-e6d2-468e-a9a2-312527e26a75",
  "expiresOn": "2015-11-24T15:36:50.1374103Z",
  "hotels": [
    {
      "id": "100122",
      "name": "Limak Lara De Luxe Hotel & Resort",
      "description": "This club resort is situated approximately 8 km from the centre of Lara and is close to the sea and a private beach on Turkey's Mediterranean coast, which is known for its richness in history and natural beauty. Antalya is 25 km from the club resort and Antalya Airport is around 13 km away.",
      "city": {
        "id": "23504",
        "name": "Lara"
      },
      "country": {
        "id": "TR",
        "name": "Turkey"
      },
      "stars": 4.5,
      "rating": 5.5977,
      "reviewUrl": "http://www.holidaycheck.com/hr/4d1251f4-2a50-3064-8551-3a7c277b7e2a",
      "thumbnail": "100122/385895.jpg",
      "themes": [
        "Tatil Köyü"
      ],
      "facilities": [],
      "geolocation": {
        "longitude": 30.88086,
        "latitude": 36.85587
      },
      "isFavorite": false,
      "offers": [
        {
          "id": "a21a0d97-8982-432d-a014-6c78a9b4f093",
          "expiresOn": "2015-11-24T15:36:50.0594296Z",
          "hotelId": "100122",
          "boardId": "1023"
          "board": "All Inclusive",
          "boardCategories": [
            "All inclusive"
          ],
          "rooms": [
            {
              "id": "74b1ab67-a73c-456b-b6ca-ffba797a2394",
              "type": "IQSP.e9c84bae-e2aa-4cab-957f-70ab3ac2f376:Standard Room - 1 double bed",
              "categories": [
                "Uncategorized"
              ],
              "promotions": [],
              "travellers": [
                {
                  "type": "adult",
                  "age": 0,
                  "nationality": "TR"
                },
                {
                  "type": "adult",
                  "age": 0,
                  "nationality": "TR"
                }
              ]
            }
          ],
          "price": {
            "amount": 923.00,
            "currency": "EUR"
          },
          "isSpecial": false,
          "isAvailable": true
        },
        {
          "id": "9f8a16fe-2a66-4f45-bec3-b19f45cc6721",
          "expiresOn": "2015-11-24T15:36:50.0594296Z",
          "hotelId": "100122",
          "board": "All Inclusive",
          "boardCategories": [
            "All inclusive"
          ],
          "rooms": [
            {
              "id": "2eac2fed-8b2f-4d5b-8c71-331691e0eee7",
              "typeId": "10023"
              "type": "IQSP.e9c84bae-e2aa-4cab-957f-70ab3ac2f376:Standard Triple Room - 1 double bed",
              "categories": [
                "Uncategorized"
              ],
              "promotions": [],
              "travellers": [
                {
                  "type": "adult",
                  "age": 0,
                  "nationality": "TR"
                },
                {
                  "type": "adult",
                  "age": 0,
                  "nationality": "TR"
                }
              ]
            }
          ],
          "price": {
            "amount": 1222.00,
            "currency": "EUR"
          },
          "isSpecial": false,
          "isAvailable": true
        },
        {
          "id": "44df9620-532f-4b58-82b5-fc032cba35e0",
          "expiresOn": "2015-11-24T15:36:50.0594296Z",
          "hotelId": "100122",
          "board": "All Inclusive",
          "boardCategories": [
            "All inclusive"
          ],
          "rooms": [
            {
              "id": "bffb75e1-be20-40fe-9bd8-77984825e812",
              "type": "IQSP.e9c84bae-e2aa-4cab-957f-70ab3ac2f376:Junior Suite, 1 King Bed",
              "categories": [
                "Uncategorized"
              ],
              "promotions": [],
              "travellers": [
                {
                  "type": "adult",
                  "age": 0,
                  "nationality": "TR"
                },
                {
                  "type": "adult",
                  "age": 0,
                  "nationality": "TR"
                }
              ]
            }
          ],
          "price": {
            "amount": 1227.00,
            "currency": "EUR"
          },
          "isSpecial": false,
          "isAvailable": true
        }
      ]
    }
  ]
}