Before we can query for hotel availability we need to load static information into our databases. Ideally, your hotel catalog should be updated daily to ensure that we always have the most up-to-date catalog.

Provided static data will be used:

• To match provider properties against our catalog¹
• To extend our catalog with provider properties

¹ - Please note that unmatched properties will not be visible in search.

Technical details

We accept multiple data exchange formats. The preferred option is to use an existing provider static data API or scheduled dump of static data. In both cases, we will extract all useful data and ensure that the maximum number of properties will be available for search. UTF-8 character encoding should be used for text fields.

Delivery

Static data must be accessible online, here are the transfer methods we support:

• HTTP, HTTPS
• FTP, FTPS
• Amazon S3
• SSH, SFTP

Format

If a provider has no API and is about to implement one to cover our needs, here is the list of preferred formats:

[
    {
        "_comment_": "Main content should always be english",
        "id": 1,
        "propertyName": "Basic hotel",
        "streetAddress": "300 Baker Avenue, Suite 380",
        "city": "Concord",
        "region": "MA",
        "country": "US",
        "postalCode": "01742",
        "latitude": 42.460105,
        "longitude": -71.390874,
        "phone": "+1 978 369 8170",
        "registrationNumber": "12345678",
        "url": "http://www.kayak.com",
        "destinationId": 258,
        "roomCount": 5,
        "floorCount": 1,
        "yearOpened": 2001,
        "yearRenovated": 2018,
        "stars": 5,
        "starSource": "AA",
        "hotelBrand": "Booking Holdings",
        "checkIn": "14:00",
        "checkOut": "12:00",
        "airport": "BOS",
        "description": "Welcome to KAYAK!",
        "hotelAmenityIds": [
            "freewifi",
            "lobby",
            "coffee/tea"
        ],
        "roomAmenityIds": [
            "television",
            "whiteboard",
            "phone",
            "conferencerooms"
        ]
    }
]

<?xml version="1.0" encoding="UTF-8"?>
<hotels>
    <hotel>
        <id>1</id>
        <propertyName>Basic hotel</propertyName>
        <streetAddress>300 Baker Avenue, Suite 380</streetAddress>
        <city>Concord</city>
        <region>MA</region>
        <country>US</country>
        <postalCode>01742</postalCode>
        <latitude>42.460105</latitude>
        <longitude>-71.390874</longitude>
        <phone>+1 978 369 8170</phone>
        <registrationNumber>12345678</registrationNumber>
        <url>http://www.kayak.com</url>
        <destinationId>258</destinationId>
        <roomCount>5</roomCount>
        <floorCount>1</floorCount>
        <yearOpened>2001</yearOpened>
        <yearRenovated>2018</yearRenovated>
        <stars>5</stars>
        <starSource>AA</starSource>
        <hotelBrand>Booking Holdings</hotelBrand>
        <checkIn>14:00</checkIn>
        <checkOut>12:00</checkOut>
        <airport>BOS</airport>
        <description>Welcome to KAYAK!</description>
        <hotel_facilities>
            <hotel_facility_id>100</hotel_facility_id>
            <name>Free WiFi</name>
        </hotel_facilities>
        <hotel_facilities>
            <hotel_facility_id>107</hotel_facility_id>
            <name>Lobby</name>
        </hotel_facilities>
        <hotel_facilities>
            <hotel_facility_id>321</hotel_facility_id>
            <name>Air Conditioning</name>
        </hotel_facilities>
    </hotel>
</hotels>

Note: If you choose to dump your full property catalog into a single file,please compress it.

Attention: We have no support for spreadsheets(XLS, XLSX, CSV, TSC, etc.)

Hotel static data requirements for basic integration

Note: please adhere to these guidelines as many of these fields are used for matching. Unmatched properties will not be visible in search. If we receive low quality hotel data, it will impede the process of getting the hotel to appear in the search results.

Room-type static data requirements

If your static data feed provides hotel/resort room-type information, please send the following fields:

Hotel Reviews static data requirements

Effective as of August 12, 2022

Currently supported languages

Specified as a Simple or Language_Region IETF language code:

• ar (Arabic)
• bg (Bulgarian)
• ca (Catalan)
• cs (Czech)
• da (Danish)
• de (German)
• el (Greek)
• en (English)
• en_GB (British English)
• es (Spanish)
• et (Estonian)
• fi (Finnish)
• hr (Croatian)
• hu (Hungarian)
• in (Indonesian)
• iw (Hebrew)
• is (Icelandic)
• it (Italian)
• ja (Japanese)
• ko (Korean)
• lv (Latvian)
• ms (Malay)
• nl (Dutch)
• no (Norwegian)
• pl (Polish)
• pt (Portuguese)
• pt_BR (Brazilian Portuguese)
• ro (Romanian)
• ru (Russian)
• sk (Slovak)
• sv (Swedish)
• th (Thai)
• tr (Turkish)
• uk (Ukrainian)
• vi (Vietnamese)
• zh_CN (Simplified Chinese)
• zh_TW (Traditional Chinese)

Hotel Image Requirements

Effective as of August 12, 2022

The following guidelines should be strictly adhered to when providing hotel and room images. Quality is measured not only by the size of the image, but by the variety of the content as well.

Image Files Recommendations

• Horizontal (Landscape) orientation:
  • 1200x800 pixels recommended, 720x480 pixels minimum
• Vertical (Portrait) orientation:
  • 800x1200 pixels recommended, 480x720 pixels minimum
• Images must be under 25MB each
• File types: JPG preferred, but PNG or GIF are accepted
• Images must be in color, not black and white
• No borders or filters
• No watermarks, copyright logos, or text

Image Content & Metadata

• Keep your content fresh and include images of all of the hotel features. Providing images of everything allows your hotel guests to imagine themselves there.
• Share images for all room types, not just your standard room. Showing a variety of images shows guests the hotels upgrade potential.
• Context matters. Choose images of room amenities within the space, not close up.
• Our tags are important for determining the order in which hotel images will be displayed. Make sure to tag your image with the most specific tag possible. For example, an image of a restaurant should be tagged as a restaurant, not food.
• Below are the type of images that should be avoided and will likely be rejected:
  • Maps
  • Close up shots of food
  • Poorly lit, blurry or difficult to view images
  • Offensive images
  • Any type of advertisement or flyer for an event at the hotel
  • Images including people where they are a distraction. The hotel should always be the primary focus of the image.
• The images provided must be originals. Images that infringe on any copyright, trademark, or other legal property rights will be rejected immediately.

Helpful Tips for Managing your Images in the Console

• Don’t skip the image tags. At KAYAK, we have a ranking algorithm in place for all of our hotel images. This helps us show images in a specific order so they aren’t repetitive.
• The primary (thumbnail) image is defaulted to the building (exterior of hotel). If there is no building image then the first bedroom tagged image will become the primary.
• You cannot delete images yourself. We never want a listing to have 0 images so we handle all image deletion for you. Please reach out to images@kayak.com for image removal assistance.

Logo File Recommendations

To ensure optimal brand recognition, please adhere to the logo recommendations below:

• File types: SVG and PNG preferred. EPS, JPG, and AI files are also accepted.
• File size: 664x248 minimum for horizontal logos and 432x248 for vertical logos
• File definitions:
  • Horizontal = brand mark next to brand name.
  • Vertical = brand mark on top of brand name.
• Unless required per your brand, all logos should have a transparent background.

Need help? Email images@kayak.com for assistance with your hotel images and provider logos.