Skip to main content

Hotels Integration Requirements

Hotel Static Data​

We'll need the static data for your complete hotel inventory. We'll use this data for matching your hotels with hotels from other partners. This will enable us to collate the data for all hotels & to fill in information that might be missing in your statc data. It will eventually serve us to display hotels comprehensively. If you have translations for hotel information such as name, description, location, etc in languages other than English, please do expose the information in the static data.

Supported Data Formats​

We support these data formats:

  • CSV
  • JSON
  • XML

The static data may be made available via email or any specified data source (URL / Web Service). If your service is behind security infrastructure, please refer to Wego IP Addresses to recognize the requests originating from Wego's IPs.

Update Frequency​

Static data should be updated at least once per month. We have the resources to set up an automated service to update the static data periodically. However, the automated service supports only the content which is made available via a datasource and not via static files. We prefer data to be exposed via a specific datasource (URL / Web Services) for ease of updating inventory.

Static Data Content​

We need the static data to contain the attributes of all your properties such as name, address, location, etc.

Mandatory Attributes​

Following attributes are mandatory for us to import the properties and run matching on them.

  • Property ID
  • Property Name
  • Property Address
  • City Name / City Code
  • Country Name / Country Code
  • Latitude
  • Longitude

Optional Attributes​

We encourage partners to include following property attributes to their static data to enrich hotels information and facilitate efficient matching:

  • Property Description
  • Property Images
  • State Code & Name
  • District Code & Name
  • Former Name
  • Nearest Landmark
  • Rating
  • Postal Code
  • Native Currency of Billing
  • Source Listing
  • Time Zone
  • Built Year
  • Renovated Year
  • Yearly Closures
  • Reservation Phone
  • Phone Numbers
  • Email of Listing
  • Fax / Telefax
  • Website / Deeplink
  • Check-in & Check-out Times
  • Rooms Count
  • Floors Count
  • Reviews
  • Reviews Count
  • Reviews Score
  • Amenities
  • Cancellation Policy
  • Chain / Brand
  • Property Type
  • Videos of Property
  • Any other information

Hotel Amenities​

We encourage you to provide hotel amenities as a part of the static data. This will help us to enrich the hotel information. Any and all amenities that you provide are good for us. However some of the common generic amenities that we insist you to expose are:

Highspeed Internet
Swimming Pool
Parking
Restaurant
Facilities for Disabled
Airconditioning
Non-smoking Rooms
Pet-friendly
Safe / Vault
Babysitting / Child Services
Meeting/Banquet Facilities
Business Centre
Car Rental
Casino
Breakfast Buffet
Airport Shuttle
Golfcourse
Spa & Wellness Centre
Fitness Centre
Bar / Lounge
Ski-In Ski-Out
Kids Activities
Tennis Court
Beach Access
Game Room
Adult Pool
Indoor Pool
Room Service
Dry Cleaning
Valet Parking

Hotel Images​

Images for all hotels must have minimum size of 350x300 pixels. We prefer high resolution images with resolution of 1000x1000 and above to facilitate dynamic image resizing by our image handling services. The images must be provided with the static data & preferably through an API or datasource.

We need partner logo with atleast 200x70 pixels resolution in any of the following formats: .png, .jpg, .gif. High resolution logos are preferable in the same aspect ratio.

Price and Availability API​

We will need access to your API in order to query real-time availability and pricing. We’ve integrated a few hundreds different hotel providers and OTA partners and should be able to work with whatever hotels API you have (however a simple JSON or XML API is preferable).

We’ll send a request to your API that includes the availability request information as described in API Types.

API Types​

The API service must support any of the following modes of query:

Hotel ID Based (preferred):​

The query is expected to retrieve information based on partner specific hotel IDs. Please provider the constraints for the maximum number of hotel IDs for which we can request information at one time using the service.

Service request will consist of:

  • Partner specific hotel ID(s)
  • Check-in & Check-out dates
  • Number of rooms
  • Number of adults
  • Number of children
  • Children ages (optional)
  • Number of nights (optional)
  • Language / Locale (optional)
  • Currency (optional)

Service response must contain:

  • Hotel ID
  • Room type (Example: Deluxe Room with Twin Bed)
  • Rate type (Breakfast for 2, Free Cancellation)
  • Currency
  • Rate details
    • Total rate inclusive of all taxes and fees
    • Base rate
    • Tax
    • Other applicable fees
  • Room description (optional)
  • Price in USD (optional)
  • Deeplink
Sample Hotel ID Based JSON Request:​
{
  "HotelAvailability": {
    "HotelID": ["ABC123", "XYZ456"],
    "checkInDate": "19/11/2015",
    "checkOutDate": "20/11/2015",
    "rooms": 2,
    "adults": 2,
    "children": 2,
    "child_ages": [6, 8],
    "currency": "SGD"
  }
}
Sample Hotel ID Based JSON Response​
{
  "Hotels": {
    "Hotel": [
      {
        "id": "ABC123",
        "currency_code": "SGD",
        "rateType": "Free Breakfast",
        "rooms": {
          "room": [
            {
              "description": "Standard Room",
              "totalRate": 1399,
              "baseRate": 1020,
              "tax": 270,
              "tourismFee": 109
            }
          ]
        },
        "deeplink": "https://www.partner.com/hotels/hotel/?check_in=19/11/2015&check_out=20/11/2015&rooms=2&adults=2&children=2&childages=6_8&refid=8363&hotel_id=700225965&currency=SGD",
        "restrictions": ["non_refundable", "no_postpaid"],
        "cancellation_policy": "For cancellation done till 18 Nov 2015, 12 PM (1 Day prior to check-in date), 100% refundable. For cancellation done after 18 Nov 2015, 12 PM (within 1 Day of check-in date), non refundable. Incase of no show, no refund will be provided. Booking cannot be cancelled or modified on or after the check-in date. Cancellation within 10 mins of booking creation is free"
      }
    ]
  }
}

Location based:​

The query is expected to retrieve information based on location information.

Service request will consist of:

  • Partner specific location name / code
  • Check-in & Check-out dates
  • Number of rooms
  • Number of adults
  • Number of children
  • Children ages (optional)
  • Number of nights (optional)
  • Language / Locale (optional)
  • Currency (optional)

Service response must contain:

  • Hotel ID
  • Room type (Example: Deluxe Room with Twin Bed)
  • Rate type (Breakfast for 2, Free Cancellation)
  • Currency
  • Rate details
    • Total rate inclusive of all taxes and fees
    • Base rate
    • Tax
    • Other applicable fees
  • Room description (optional)
  • Price in USD (optional)
  • Deeplink
Sample Location Based XML Request:​
<HotelAvailability>
  <City> Dubai </City>
  <StartDate> 2019-10-23 </StartDate>
  <EndDate> 2019-12-01 </EndDate>
  <NumRooms> 1 </NumRooms>
  <NumAdults> 2 </NumAdults>
  <NumChildren> 1 </NumChildren>
</HotelAvailability>
Sample Location Based XML Response:​
<?xml version="1.0" encoding="iso-8859-1"?>
<Hotels>
  <Hotel>
    <ID> 1000000 </ID>
    <Name> Burj Al Arab </Name>
    <Rating> 5 </Rating>
    <StreetAddress> 123, Sheikh Zayed Street </StreetAddress>
    <PostalCode> 75014 </PostalCode>
    <Description> The greatest hotel in the world </Description>
    <City> Dubai </City>
    <Country> United Arab Emirates </Country>
    <CurrencyCode> AED </CurrencyCode>
    <Rooms>
      <Room>
        <RoomID> 67594 </RoomID>
        <Description> 1 Double </Description>
        <RatePerNight> 18000.00 </RatePerNight>
        <BaseRatePerNight> 16550 </BaseRatePerNight>
        <TaxPerNight> 1050 </TaxPerNight>
        <CityTaxPerNight> 400 </CityTaxPerNight>
      </Room>
      <Room>
        <RoomID> 67594 </RoomID>
        <Description> 1 Single </Description>
        <RatePerNight> 100.00 </RatePerNight>
      </Room>
    </Rooms>
  </Hotel>
</Hotels>

Other Constraints​

If your service has some constraints, please communicate them to us. Some example constraints could be:

  • There's no support for number of rooms in request
  • The duration of stay cannot be longer than a week
  • Maximum 4 people supported in a room
  • Children are not supported in request

Price Breakdown and Rate Amenities​

We insist that you provide a price breakdown for each rate as a part of Availability API response to enable us in presenting rates comprehensively. The price breakdown must outline how the total price is distributed amongst base price, taxes and fees. Any taxes and fees exposed must also specify what type of tax or fee it represents.

We encourage you to provide rate amenities associated with each room rate in the Availability API response. The rate amenities we support generically are:

Free Cancellation
Free Wi-fi
Breakfast Included
Smoking Room
Pay Later
Free Parking
Club Floor Access
Match Price
Special Rate
Full Board Meal
Half Board Meal
No Credit Card Needed
Pay at the Hotel
SHETAB Accepted
SADAD Accepted
KNET Accepted
Instant Booking
Mobile Exclusive
Member Exclusive
Free Room

Below is a sample excerpt from API response with rate ameneties & price breakdown:

...
  "RatePlans": [
    {
      "RoomTypeId": "200553936",
      "StayDates": {
        "CheckInDate": "2019-02-10",
        "CheckOutDate": "2019-02-14"
      },
      "RemainingCount": 5,
      "Price": {
        "BaseRate": "1832.40",
        "TaxesAndFees": "412.28",
        "TotalPrice": "2244.68",
        "AvgNightlyRate": "458.10",
        "HotelMandatoryFees": "60.00"
      },
      "PaymentMethod": "Online",
      "FreeInternet": true,
      "FreeWiFi": true,
      "FreeParking": false,
      "FreeBreakfast": false,
      "CancellationPolicy": {
        "Refundable": false,
        "FreeCancellation": false
      }
    }
  ]
...

Languages and Currencies​

Please provide the complete list of languages and currency codes you support.

Caching Strategy​

Please advise how long results can be safely cached. Using this information, we can cache responses from your API to minimize the number of live queries sent to your API server. Our default caching time is 2 hours.

For each hotel result we need a way to “deeplink” the user into your website directly for the specific offer. Best practices for conversion is to redirect users via the deeplink directly to the booking/summary page with the hotel rate the user has selected on the Wego website.

Wego supports more than 50 points of sales (POS) and each POS has its own supported language. We will need a mapping between your POS and our POS and a list of supported currencies and languages which you support so that we can create the best experience for our users by directing them from our site to the most appropriate POS on your site. The deeplink to the booking page must be able to accomodate check-in & check-out dates, number of rooms & guests information. Additionally, the deeplink should also accomodate currency and locale so that the user is redirected to the booking page with his/her selected currency and locale.

Ideally a Booking/Deeplink URL is to be provided in each hotel node in your API response. Alternatively you can provide deeplink documentation on how to construct the deeplink. Wego will generate the actual deeplink in real time for each click. Any affiliate tags or tracking parameters that you require us to include in the deeplink must be specified clearly. If your mobile and desktop deeplinks are different, both desktop and mobile deeplink URL examples must be shared.

Here's a sample deeplink for reference:

https://www.partner.com/hotels/hotel/?check_in=03/11/2020&check_out=03/13/2020&rooms=1&adults=1&refid=8363&hotel_id=700225965&currency=SGD

Please advise if you require us to add any tracking parameters to our deeplinks in order for you to track referrals from Wego in your reporting systems. Please refer to Conversion tracking for more information on tracking.

Wego IP Addresses​

Please whitelist our IP addresses:

34.197.140.76
34.199.34.219
52.76.245.157
52.76.246.12

To get started, once you have signed a Commercial Agreement with Wego, please send your API documentation and login details to your Wego Account manager.