Partner-API documentation home
Overview
The Viator Partner API comprises a set of endpoints that can support the operation of a fully-featured tours and experiences booking website or application; or, it can be integrated with your existing travel-booking software.
The API exposes a variety of services that allow the retrieval of all product details, such as descriptions, pricing, terms and conditions, photos and reviews. This data can either be ingested periodically and managed on your local system, or calls can be made in real time to retrieve content in response to your users' activity on your systems.
The API allows product availability schedules to be retrieved in bulk or queried in real-time, and it can perform pricing calculations according to the number and type of traveler for the wide variety of product option combinations typically available in the tours and activities sales workflow.
The API provides booking and post-booking functionality, allowing booking requests, ticket purchase, and booking status updates.
Various utility services are available to map between yours and Viator's data taxonomy.
- Please note: The API does not provide services for storing data, such as user accounts. We assume that merchant partners have their own systems for storing this data.
Who is the API for?
The Viator Partner API is designed for use by both organizations and individuals partnered with Viator as commerce or content API partners. For more information about how you can and why you might become a Viator API partner, see:
There are two main categories of partner: merchant and affiliate.
Merchant partners
A merchant partner is one who operates as the merchant of record; i.e., takes full responsibility for all monetary transactions carried out by their users, as well as providing customer support with regard to providing help, processing cancellations and refunds, and liaising between suppliers and customers when the need to communicate information arises.
Merchant partners are invoiced periodically by Viator for all product sales. You will need to demonstrate that you have access to the appropriate infrastructure to effectively support the requisite business operations in order to become a merchant partner.
Affiliate partners
Affiliate partners have full access to the areas of the API relating to content, but sales of Viator products must be carried out on the Viator site itself; therefore, access to the booking or transactional endpoints necessary to operate as the merchant of record (i.e., merchant partners) is restricted.
When a customer wishes to book a product from a VBA partner's site, they are instead redirected to viator.com in order to complete the purchase; whereas, merchant partners are able to process and manage bookings through the Viator API itself, allowing their customers to book products without leaving the partner's site.
Viator affiliates instead generate unique URLs that redirect their users to the Viator site, resulting in a cookie being set such that all transactions will accrue a commission for that partner until the cookie expires.
Purchases of products originating from the VBAs site are recorded and a commission on these sales is paid periodically.
Technical documentation
This site is home to the Viator Partner API v2.0 specification and technical documentation. This is the primary document you will need to refer to in order to integrate with this API.
Additional resources
- Viator Partner Resource Center – information about becoming a Viator API partner
- Viator Partner Help Center – answers to frequently asked questions
- Merchant partner support FAQs – includes information about the scope of the support we provide and how to access it
- Technical guide for API partners – a simplified technical guide for business/overview purposes
- Front-End Guide for API Partners – recommendations and technical advice about how to build an optimal front-end for your travel site