Hotel Product

Access real-time, comprehensive hotel rates, availability and booking options with Hotels.

img


GetArrivalAutocomplete Method

Last Update Date 14.12.2020
Method Adress /api/productservice/getarrivalautocomplete
Method Type POST
Token Required YES

Request Sample

Click to reach the product types.

{
   "ProductType":2,
   "Query":"anta"
}

Response Sample

{
  "header": {
    "requestId": "723f1089-7c9d-4fb1-9423-bc018e79f30e",
    "success": true,
    "messages": [
      {
        "id": 10000000,
        "code": "OperationCompleted",
        "messageType": 2,
        "message": "Operation was completed successfully"
      }
    ]
  },
  "body": {
    "items": [
      {
        "type": 1,
        "geolocation": {
          "longitude": "30.70838",
          "latitude": "36.87536"
        },
        "country": {
          "id": "TR",
          "name": "Turkey"
        },
        "state": {
          "id": "10828",
          "name": "Turkish Riviera"
        },
        "city": {
          "id": "23494",
          "name": "Antalya"
        },
        "giataInfo": {
          "hotelId": "1269469",
          "destinationId": "930"
        },
        "provider": 2
      }
    ]
  }
}

PriceSearch Method

You can use PriceSearch for getting hotel prices.

Last Update Date 17.12.2020
Method Adress /api/productservice/pricesearch
Method Type POST
Token Required YES

Request Sample ( For A Certain Location )

Click to reach the product types.

{
  "currency":"EUR",
  "culture":"en-US",
  "checkAllotment":true,
  "checkStopSale":true,
  "getOnlyDiscountedPrice":false,
  "productType":2,
  "arrivalLocations":[
      {
        "id":"23494",
        "type":2
     }
  ],
  "roomCriteria":[
     {
        "adult":2,
        "childAges":[
           2,
           5
        ]
     },
     {
        "adult":1,
        "childAges":[
           3
        ]
     }
  ],
  "nationality":"DE",
  "checkIn":"2020-10-27",
  "night":1
}

Request Sample ( For A Certain Hotel )

Click to reach the product types.

{
   "currency":"EUR",
   "culture":"en-US",
   "checkAllotment":true,
   "checkStopSale":true,
   "getOnlyDiscountedPrice":false,
   "productType":2,
   "Products":[
      "101044"
   ],
   "roomCriteria":[
      {
         "adult":2
      }
   ],
   "nationality":"DE",
   "checkIn":"2020-10-27",
   "night":1
}

Response Sample

{
  "header": {
    "requestId": "2258f243-1975-4f0d-8250-60d36887a6a4",
    "success": true,
    "messages": [
      {
        "id": 10000000,
        "code": "OperationCompleted",
        "messageType": 2,
        "message": "Operation was completed successfully"
      }
    ]
  },
  "body": {
    "searchId": "0967b3d6-a237-4dbc-bf19-cd79f39cab57",
    "expiresOn": "2020-10-27T14:22:48.8184312Z",
    "hotels": [
      {
        "geolocation": {
          "longitude": "30.537600000",
          "latitude": "36.508700000"
        },
        "stars": 5,
        "themes": [
          {
            "id": "1",
            "name": "FAMILY"
          },
          {
            "id": "4",
            "name": "BEST BUY"
          },
          {
            "id": "7",
            "name": "ALL INCLUSIVE"
          }
        ],
        "country": {
          "name": "TURKEY",
          "latitude": "11.000000000",
          "longitude": "11.000000000",
          "provider": 0,
          "id": "5"
        },
        "city": {
          "name": "Antalya",
          "latitude": "36.898731000",
          "longitude": "30.800461000",
          "provider": 0,
          "id": "22177"
        },
        "giataInfo": {
          "hotelId": "1269469",
          "destinationId": "930"
        },
        "town": {
          "name": "BELEK TV",
          "latitude": "36.856770000",
          "longitude": "30.851300000",
          "provider": 0,
          "id": "3694"
        },
        "village": {
          "name": "BOGAZKENT",
          "provider": 0,
          "id": "3706"
        },
        "offers": [
          {
            "night": 1,
            "isAvailable": false,
            "rooms": [
              {
                "roomId": "6941",
                "roomName": "STANDARD ROOM",
                "roomGroups": [],
                "accomId": "16287",
                "accomName": "DOUBLE ROOM",
                "boardId": "4592",
                "boardName": "ALL INCLUSIVE",
                "boardGroups": [],
                "allotment": 10000,
                "stopSaleGuaranteed": 0,
                "stopSaleStandart": 0,
                "price": {
                  "amount": 42.00375,
                  "currency": "EUR"
                },
                "travellers": [
                  { "type": 1 },
                  { "type": 1 }
                ]
              }
            ],
            "isRefundable": false,
            "offerId": "1-2--DE-1|2889381-455-2",
            "checkIn": "2020-10-27T00:00:00",
            "price": {
              "amount": 42.00375,
              "currency": "EUR"
            },
            "ownOffer": true
          },
          {
            "night": 1,
            "isAvailable": false,
            "rooms": [
              {
                "roomId": "6942",
                "roomName": "DELUX ROOM",
                "roomGroups": [],
                "accomId": "16289",
                "accomName": "DOUBLE ROOM",
                "boardId": "4592",
                "boardName": "ALL INCLUSIVE",
                "boardGroups": [],
                "allotment": 10000,
                "stopSaleGuaranteed": 0,
                "stopSaleStandart": 0,
                "price": {
                  "amount": 56.005,
                  "currency": "EUR"
                },
                "travellers": [
                  { "type": 1 },
                  { "type": 1 }
                ]
              }
            ],
            "isRefundable": false,
            "offerId": "1-2--DE-1|2886797-455-2",
            "checkIn": "2020-10-27T00:00:00",
            "price": {
              "amount": 56.005,
              "currency": "EUR"
            },
            "ownOffer": true
          }
        ],
        "address": "Tekirova Mahallesi, 07995 Kemer/Antalya, Türkiye",
        "provider": 1,
        "thumbnail": "/images/product/1/2/1/4481/fatih_test-en-us.jpg",
        "description": { "text": "<p>GERMAN CULTURE, Category = SEARCH<\/p>" },
        "id": "4481",
        "name": "FATIH TEST-EN-US"
      }
    ],
    "details": {
      "enablePaging": false,
      "getOnlyBestOffers": false
    }
  }
}

GetProductInfo Method

You can use GetProductInfo for getting hotel media information without prices.

Last Update Date 14.12.2020
Method Adress /api/productservice/getproductInfo
Method Type POST
Token Required YES

Request Sample

Click to reach the product types.

{
  "culture": "en-US",
  "productType": 2,

  <!--If working a single provider is not required. But it is required if you work with multiple provider.
  e.g. TourVisio + Paximum hotels. This value in pricesearchresponse. hotel.provider-->
  "ownerProvider": 2,

  <!--This value in pricesearchresponse. hotel.id-->
  "product": "31"
}

Response Sample

{
  "header": {
    "requestId": "621d45e6-59b1-45f3-b1eb-e64f5ad206e0",
    "success": true,
    "messages": [
      {
        "id": 10000000,
        "code": "OperationCompleted",
        "messageType": 2,
        "message": "Operation was completed successfully"
      }
    ]
  },
  "body": {
    "hotel": {
      "seasons": [
        {
          "id": 1028,
          "name": "NAME ALANI / ELA",
          "beginDate": "2020-03-28T00:00:00",
          "endDate": "2023-12-31T00:00:00",
          "textCategories": [
            {
              "code": "DETAIL1",
              "name": "DETAIL PAGE 1 USA",
              "presentations": [
                {
                  "textType": 1,
                  "text": "<p>wlcome</p>"
                }
              ]
            },
            {
              "code": "DETAIL2",
              "name": "DETAIL PAGE 2",
              "presentations": [
                {
                  "textType": 1,
                  "text": "<p>&nbsp;<span style=\"color: rgb(112, 112, 112); font-family: ProximaNova_Regular, Arial, Helvetica, sans-serif; font-size: 18px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: 2; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgb(255, 255, 255); display: inline !important; float: none;\">Dummy text (usually Latin) is filler content that allows our clients to view their design without being distracted by the content. By using unreadable text, clients can see how the page will look on a surface level, ensuring that the colors, ratios, and specific design elements work together.</span></p>"
                }
              ]
            },
            {
              "code": "DETAIL3",
              "name": "DETAIL PAGE 3",
              "presentations": [
                {
                  "textType": 1,
                  "text": "<p>Presentation text alan�ndan girilen bilgi</p><p><strong style=\"margin: 0px; padding: 0px; color: rgb(0, 0, 0); font-family: &quot;Open Sans&quot;, Arial, sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; letter-spacing: normal; orphans: 2; text-align: justify; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgb(255, 255, 255);\">Lorem Ipsum</strong><span style=\"color: rgb(0, 0, 0); font-family: &quot;Open Sans&quot;, Arial, sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: 2; text-align: justify; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgb(255, 255, 255); display: inline !important; float: none;\"><span class=\"Apple-converted-space\">&nbsp;</span>is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book. It has survived not only five centuries, but also the leap into electronic typesetting, remaining essentially unchanged. It was popularised in the 1960s with the release of Letraset sheets containing Lorem Ipsum passages, and more recently with desktop publishing software like Aldus PageMaker including versions of Lorem Ipsum.</span></p>"
                }
              ]
            },
            {
              "code": "SEARCH",
              "name": "SEARCH",
              "presentations": [
                {
                  "textType": 1,
                  "text": "<p>&nbsp;<span style=\"color: rgb(0, 0, 0); font-family: &quot;Open Sans&quot;, Arial, sans-serif; font-size: 14px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: 2; text-align: justify; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgb(255, 255, 255); text-decoration-style: initial; text-decoration-color: initial; display: inline !important; float: none;\">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vivamus finibus tortor sed pretium imperdiet. Aliquam facilisis pulvinar enim vel lacinia. Sed varius commodo sapien, nec egestas sapien iaculis vitae. Ut vitae luctus lacus. Quisque sodales eu massa ac faucibus. Suspendisse potenti. Mauris porta nisi ut purus consectetur vulputate.</span></p>"
                }
              ]
            }
          ],
          "facilityCategories": [
            {
              "name": "Undefined Facility Category",
              "facilities": [
                {
                  "id": "16",
                  "name": "Clinic",
                  "note": "",
                  "isPriced": false
                },
                {
                  "id": "19",
                  "name": "Conference Hall",
                  "note": "",
                  "isPriced": false
                },
                {
                  "id": "20",
                  "name": "Credit Card",
                  "note": "",
                  "isPriced": true
                },
                {
                  "id": "21",
                  "name": "Disco",
                  "unit": "6",
                  "note": "",
                  "isPriced": false
                },
                {
                  "id": "22",
                  "name": "Diving",
                  "note": "",
                  "isPriced": false
                },
                {
                  "id": "23",
                  "name": "Doctor",
                  "note": "",
                  "isPriced": false
                },
                {
                  "id": "24",
                  "name": "Exchange",
                  "unit": "5",
                  "note": "NOTE",
                  "isPriced": true
                },
                {
                  "id": "25",
                  "name": "Fine Pebble Beach",
                  "note": "",
                  "isPriced": false
                },
                {
                  "id": "26",
                  "name": "Fitness Center",
                  "note": "",
                  "isPriced": false
                },
                {
                  "id": "27",
                  "name": "Gift Shop",
                  "unit": "4",
                  "note": "",
                  "isPriced": false
                },
                {
                  "id": "28",
                  "name": "Golf",
                  "note": "",
                  "isPriced": true
                },
                {
                  "id": "29",
                  "name": "Golf Course",
                  "note": "",
                  "isPriced": false
                },
                {
                  "id": "30",
                  "name": "GYM",
                  "note": "",
                  "isPriced": false
                },
                {
                  "id": "31",
                  "name": "Hair Dressing Saloon",
                  "note": "",
                  "isPriced": false
                },
                {
                  "id": "17",
                  "name": "Indoor Pool",
                  "note": "",
                  "isPriced": false
                },
                {
                  "id": "36",
                  "name": "Kids Pool",
                  "note": "",
                  "isPriced": false
                },
                {
                  "id": "40",
                  "name": "Massage Center",
                  "note": "",
                  "isPriced": false
                },
                {
                  "id": "18",
                  "name": "Outdoor Pool",
                  "note": "",
                  "isPriced": false
                }
              ]
            }
          ],
          "mediaFiles": [
            {
              "fileType": 0,
              "url": "/images/product/1/2/2/507/sales_amelia_beach_resort_507.jpg"
            },
            {
              "fileType": 0,
              "url": "/images/product/1/2/2/508/sales_amelia_beach_resort_508.jpg"
            },
            {
              "fileType": 0,
              "url": "/images/product/1/2/2/509/sales_amelia_beach_resort_509.jpg"
            },
            {
              "fileType": 0,
              "url": "/images/product/1/2/2/510/sales_amelia_beach_resort_510.jpg"
            },
            {
              "fileType": 0,
              "url": "/images/product/1/2/2/511/sales_amelia_beach_resort_511.jpg"
            },
            {
              "fileType": 0,
              "url": "/images/product/1/2/2/512/sales_amelia_beach_resort_512.jpg"
            },
            {
              "fileType": 0,
              "url": "/images/product/1/2/2/513/sales_amelia_beach_resort_513.jpg"
            },
            {
              "fileType": 0,
              "url": "/images/product/1/2/2/514/sales_amelia_beach_resort_514.jpg"
            },
            {
              "fileType": 0,
              "url": "/images/product/1/2/2/515/sales_amelia_beach_resort_515.jpg"
            },
            {
              "fileType": 0,
              "url": "/images/product/1/2/2/516/sales_amelia_beach_resort_516.jpg"
            },
            {
              "fileType": 0,
              "url": "/images/product/1/2/2/517/sales_amelia_beach_resort_517.jpg"
            },
            {
              "fileType": 0,
              "url": "/images/product/1/2/2/518/sales_amelia_beach_resort_518.jpg"
            }
          ],
          "themes": [
            {
              "id": "1",
              "name": "FAMILY"
            },
            {
              "id": "2",
              "name": "AQUA"
            },
            {
              "id": "3",
              "name": "SKI"
            },
            {
              "id": "4",
              "name": "BEST BUY"
            },
            {
              "id": "5",
              "name": "ECONOMY"
            },
            {
              "id": "6",
              "name": "BEACH"
            },
            {
              "id": "7",
              "name": "ALL INCLUSIVE"
            },
            {
              "id": "8",
              "name": "CITY"
            },
            {
              "id": "9",
              "name": "LUXURY"
            },
            {
              "id": "10",
              "name": "SPA & RELAX"
            },
            {
              "id": "11",
              "name": "ADULTS ONLY"
            }
          ]
        }
      ],
      "address": { "addressLines": [ "TEKNOKENT OFFICE" ] },
      "faxNumber": "",
      "phoneNumber": "",
      "homePage": "",
      "geolocation": {
        "longitude": "31.608400000",
        "latitude": "36.686800000"
      },
      "stars": 4.0,
      "country": {
        "name": "TURKEY",
        "latitude": "11.000000000",
        "longitude": "11.000000000",
        "provider": 0,
        "id": "5"
      },
      "city": {
        "name": "Antalya",
        "latitude": "36.898731000",
        "longitude": "30.800461000",
        "provider": 0,
        "id": "22177"
      },
      "giataInfo": {
        "hotelId": "32308",
        "destinationId": "10211"
      },
      "thumbnail": "/images/product/1/2/1/31/sales_amelia_beach_resort.jpg",
      "id": "31",
      "name": "SALES Amelia Beach Resort"
    }
  }
}

GetOfferDetails Method (Optional)

You have to use this method before starting the booking process for any offer that you had received by using price search method. This method is going to show you whether or not that offer was still valid. At the same time, using this method, you can get cancellation rules about an offer which you couldn't get via price search.

Attention, don't continue to the booking step without checking validity of the offer!

Last Update Date 03.11.2020
Method Adress /api/productservice/getofferdetails
Method Type POST
Token Required YES

Request Sample

{
   "offerIds":[
      "2-2-adfca929-e4ca-4971-b58f-d30b33080d47"
   ]
}

Response Sample

{
   "header":{
      "requestId":"8229f06d-106f-4494-a419-c619f32e6dc5",
      "success":true,
      "messages":[
         {
            "id":10000000,
            "code":"OperationCompleted",
            "messageType":2,
            "message":"Operation was completed successfully"
         }
      ]
   },
   "body":{
      "offerDetails":[
         {
            "expiresOn":"2020-04-03T14:33:18.913654Z",
            "offerId":"2-2-adfca929-e4ca-4971-b58f-d30b33080d47",
            "checkIn":"2020-04-17T00:00:00Z",
            "checkOut":"2020-04-18T00:00:00Z",
            "isSpecial":true,
            "isAvailable":true,
            "isRefundable":true,
            "notes":"Check-in hour 14:00 – . Only Adults. ***The Platform beach is open from 15 May 2019 through 01 October 2019. Opening and closing dates may change acoording to the wheather conditions***",
            "price":{
               "amount":58.9779450,
               "currency":"EUR"
            },
            "cancellationPolicies":[
               {
                  "dueDate":"2020-04-11T00:00:00Z",
                  "price":{
                     "amount":58.9779450,
                     "currency":"EUR"
                  }
               }
            ]
         }
      ]
   }
}