Skip to main content

Getting started

The Vio.com API is a lightweight and portable JSON API that can enrich your travel product with comparison capabilities across a large number of online travel agencies such as Expedia, Trip.com, Agoda, Vio.com and many others. The Partner API is a simpler interface to the API that we use on our own own customer-facing product: Vio.com. It is a battle-tested API that serves millions of customers every month and that your business can rely on.

Partner onboarding​

In order to use the API you need to have a revenue share agreement with us. Write to affiliate@vio.com so that we can discuss terms and onboard you as a partner in our platform. During the onboarding we will assign to you an account manager that will serve as your single point of contact with Vio.com.

Authentication​

The API uses basic authentication with a profile key that needs to be passed in the X-Partner-Key header of every request. Your account manager will provide your profile key during the onboarding.

Hotel mapping​

Some API capabilities require us to map your hotel database to Vio.com's hotel database. If this is applicable to your use case your account manager will guide you through the hotel mapping process.

Your First API Request​

You can now make your first API request using the provided profile key:

curl --request POST 'https://partners.api.vio.com/v1/search' \
--header 'X-Partner-Key: <profile key>' \
--header 'Content-Type: application/json' \
--data-raw '{
"checkIn": "2024-06-19",
"checkOut": "2024-06-20",
"query": {
    "hotelNames": {
        "names": [
            "New York - New York Hotel and Casino",
            "Palms Place Hotel and Spa",
            "The Palazzo at The Venetian"
        ],
        "city": "Las Vegas",
        "country": "United States"
    }
},
"rooms": "2",
"language": "en",
"currency": "EUR"
}'