Tours

The Tours API provides online access to tours, tickets, tourist attractions and other activities, using data from multiple providers.

Get tours from Viator

Let's get some tours in London:

GET https://api.sygictravelapi.com/1.0/en/tours/viator?parent_place_id=city:1



We will get an array of tour entities in the following format:

{
    "id": "9098P12",
    "supplier": "viator",
    "title": "Luxury Rolls Royce at Your Disposal in London Including a Chauffeur",
    "perex": "Hiring a Rolls Royce will make any trip to London special. Whether you’re...",
    "url": "https://www.partner.viator.com/en/13008/tours/London/Luxury-Rolls-Royce-at-Your-Disposal-in-London-Including-a-Chauffeur/d737-9098P12",
    "rating": 0.0,
    "review_count": 0,
    "photo_url": "https://cache-graphicslib.viator.com/graphicslib/thumbs674x446/9098/SITours/luxury-rolls-royce-at-your-disposal-in-london-including-a-chauffeur-in-london-274674.jpg",
    "price": 2241.69,
    "original_price": 0.0,
    "duration": "8 hours"
}

Now we can display this specific tour with some basic info, picture (photo_url) and a link to the provider's website (url) where customers can see tour details and make a booking. The link can contain your affiliate ID obtained directly from the tour provider.

Requested tours can be sorted by various criteria and paginated. For a full list of possible parameters see the API specification.

Get tours from Get Your Guide

Similarly, we can get tours in London from the Get Your Guide provider:

GET https://api.sygictravelapi.com/1.0/en/tours/get-your-guide?parent_place_id=city:1

The response is very similar to the Viator one and provides all the basic infomation needed for displaying the tour in an UI. Again, the link to tour detail on provider's website (url) can contain your affiliate ID.

The Get Your Guide provider offers a richer tour search and filter capabilities. Tours are searchable not only by their parent destination but also by a fulltext query, geographical bounds, tags, duration and others. Exact dates can be specified to obtain available tours only. For the full list of possible parameters see the API specification.

If you want to display only the top tours that meet your criteria but at the same time need to include the numbers of all tours matching the individual tags, you can use the stats endpoint with the same filters you would use for getting the tours data. Let's get the tour tag stats for London:

GET https://api.sygictravelapi.com/1.0/en/tours/get-your-guide/stats?parent_place_id=city:1

You will get a list of tags and the number of matching tours for each one of them.