Attraction Booking Solutions

Tripadvisor & Viator are offering a joint solution that allows partners to (1) take advantage of the rich attraction database to help users find and explore local things to do as powered by Tripadvisor and (2) offer the ability for consumers to then complete their booking for those eligible things to do via an integration with our sister company Viator.

Tripadvisor’s JSON Partner API can be used to get dynamic access to Tripadvisor content. Partners can build their applications by calling the API, parsing the response, and displaying the data from the response on their site. Example content includes TA ratings, reviews, and links. Input options and partner configuration settings control the amount and type of data returned. 

Opportunities exist to direct users to Tripadvisor or Viator depending on the business model. Contact your Business Development Representative for more information.

 

Tripadvisor Offering

Tripadvisor has the largest database of attractions globally (also referred to as Points of Interest AKA POIs). It provides a single point of access for things to coverage globally along with content / descriptions provided by owners and ratings, reviews, and recommendations based on rich user data. This solution can help drive engagement with users looking to explore local area information. With a Tripadvisor Attractions partnership, access to global Viator activities (i.e. tours, tickets, events) is available through the following models:

 

Relationship between Tripadvisor Locations and Viator Inventory

Tripadvisor will identify a POI as a location in our system. Each POI is then mapped to a set of Viator booking options which include, but is not necessarily limited to, that POI. For example, the Fenway Park a POI listed on Tripadvisor but for this POI we have 5 different inventory options that include access to Fenway Park. The list is based on how contextual the product is in relation to the POI. The hierarchy of results returned are:

 

A geographical location (i.e. Boston)

  • Point of Interest #1 (i.e. Fenway Park)
    • Tour Option 1
    • Tour Option 2
    • Tour Option 3
    • Etc…
  • Point of Interest #2 (i.e. Museum of Fine Arts)
    • Tour Option 1
    • Tour Option 2
    • Tour Option 3
    • Etc…

 

API Calls

The Partner API is flexible enough to allow multiple integration options to allow various entry points to the content including:

 Geo

  • For a given Geo location (i.e. Boston), provides an overview of the Geo and the list of top Attractions within that geo sorted by ranking. Refer to location-attractions documentation for additional information.
  • For a given Geo location, provides a filterable list of bookable activities. Refer to location-activities documentation for additional information.

Things to do in London

 

 

Attraction: For a given Tripadvisor Attraction, returns metadata, user reviews, and activity products related to this POI. Refer to location documentation for additional information.

Parliament

 

Map: For a given Location ID or Lat Long Coordinates, returns nearby Attractions and corresponding bookable Activities. Refer to map-attractions documentation for additional information.

 

Tripadvisor Entity Overview

Tripadvisor currently has 690K attraction POIs covering a multitiude of attraction types, ranging from clubs to Historic Sites to Landmarks. Elements of the POI for attractions available for distribution include:

Entity Information

  • Attraction Name
  • Property Category
  • Description
  • Hours of Operation
  • Contact details (phone number, website)

Location information

  • Geo Mapping: Primary Location (city or area within city) and mapping up to country
  • Address information including street address, city, postal code
  • Latitude / longitude for mapping
  • Neighborhood (if available)

 

Sample: Attraction Entity Information

Attraction Entity info on TA

 

User Generated Content 

  • Overall ratings
  • Overall number of reviews
  • Ranking within Geo and Category
  • Awards
  • User provided photos
  • Individual review text, date of visit, overall rating
  • Management response, if provided
  • Username, number of reviews, user type, user hero image

 

 

Sample: User Generated Content

Attraction Booking UGC

 

Activity Listing Overview

Elements of the POI for attractions available for distribution in the API are contained within the attraction_booking object in the API responses. Available data includes:

  • Whether the POI is bookable (including the ability to only return bookable activities)
  • Total count of activities available on Viator
  • Entity Information (Up to 20 per POI)
  • Hotel Pick Up Available 
  • Inclusions & Exclusions
  • Departure Point & Return Details
  • Tour Name
  • Description
  • From price point (localized per currency)
  • Viator photo (in three sizes)
  • Activity Groups & Categories (ex. Sightseeting Tickets & Passes, Skip the LIne Tours, Viator VIP & Exclusive Tours)
  • Link to POI page on Tripadvisor or Viator
  • Links to Individual activities pre-coded with Viator and Tripadvisor Tracking IDs.

 

 

Sample JSON Response 

 

 "attraction_booking": {
    "bookable": true,
    "total_results": "99",
    "results": "20",
    "activity_list_url": "https://www.tripadvisor.com/Attraction_Products-g186338-d211708-mMCID-Houses_of_Parliament-London_England.html",
    "activity_list": [
      {
        "title": "Inside the Houses of Parliament and Westminster Abbey Tour in London",
        "price": "141",
        "currency": "USD",
        "url": "https://www.tripadvisor.com/AttractionProductDetail?product=185211PARLON&d=0&partner=Viator&m=MCID",
        "description": "Get acquainted with two iconic London monuments on a 4-hour tour of Westminster Abbey and the Houses of Parliament. While gaining fascinating insight into the royal history of Great Britain, you’ll absorb the Gothic grandeur of Westminster Abbey’s interior and head inside the Houses of Parliament — home to the renowned Big Ben — to see highlights like the House of Commons and Lord’s Chamber. From your guide, you’ll learn about the United Kingdom’s political system and major historic events while touring the prominent landmarks.",
        "hotel_pickup": false,
        "images": {
          "small": {
            "width": "75",
            "url": "http://cache-graphicslib.viator.com/graphicslib/thumbs75/18521/SITours/inside-the-houses-of-parliament-and-westminster-abbey-tour-in-london-in-london-239513.jpg",
            "height": "75"
          },
          "large": {
            "width": "674",
            "url": "http://cache-graphicslib.viator.com/graphicslib/thumbs674x446/18521/SITours/inside-the-houses-of-parliament-and-westminster-abbey-tour-in-london-in-london-239513.jpg",
            "height": "446"
          },
          "medium": {
            "width": "360",
            "url": "http://cache-graphicslib.viator.com/graphicslib/thumbs360x240/18521/SITours/inside-the-houses-of-parliament-and-westminster-abbey-tour-in-london-in-london-239513.jpg",
            "height": "240"
          }
        },
        "departure_point": "Westminster Abbey, central London",
        "return_details": "Westminster Abbey, central London",
        "inclusions": [
          "Professional guide",
          "Entrance fee to Parliament and Westminster Abbey"
        ],
        "exclusions": [
          "Gratuities (optional)",
          "Hotel pickup and drop-off",
          "Food and drinks",
          "Transportation",
          "Souvenirs"
        ],
        "groups": [
          {
            "name": "Cultural & Theme Tours",
            "categories": [
              {
                "name": "Historical & Heritage Tours",
                "localized_name": "Historical & Heritage Tours"
              }
            ],
            "localized_name": "Cultural & Theme Tours"
          },
          {
            "name": "Tours & Sightseeing",
            "categories": [
              {
                "name": "Half-day Tours",
                "localized_name": "Half-day Tours"
              }
            ],
            "localized_name": "Tours & Sightseeing"
          }
        ]
      },

 

Sample: Entity Information on Tripadvisor (Note: Not all information is returned in the API)

Inside the Houses of Parliament Westminster Abbey Tour in London

 

 

Sample: Entity Information on Viator (Note: Not all information is returned in the API)

Attraction Booking Entity on VIator

 

Language Support

Activity booking is available on the following Viator-supported points of sale (POS). API calls made with the corresponding TA language code will result in a localized response and link to the product on Viator. Note: not all products are available on all POS.

 

Language

TA Language Codes

Viator POS

English

en_AU, en_CA, en_HK, en_IE, en_IN, en_MY, en_NZ, en_PH, en_SG, en_UK, en_US, en_ZA

viator.com

German

de, de_AT, de_CH

viatorcom.de

French

fr, fr_BE, fr_CA, fr_CH

viatorcom.fr

Spanish

es, es_AR, es_CL,  es_CO, es_MX, es_PE, es_VE

es.viator.com

Italian

it, it_CH

it.viator.com

Portuguese

pt

br.viator.com

Danish

da

dk.viator.com

Dutch

nl, nl_BE

viatorcom.nl

Norwegian

no

viatorcom.no

Swedish

sv

viatorcom.se

Japanese

ja

jp.viator.com

 

 

Viator Co-branded Site

Link as provided in the API will send user to the corresponding product on the localized version of Viator.com. The site is also mobile optimized. All bookings done in the session will be tracked to the corresponding Viator.com tracking ID. Note: Bookings made on the Viator app are not considered part of this program.

 

 

Viator Mobile Web Example

Attraction Booking Entity on MW

 

 

Example Implementations

Destination Landing Page

Destination Landing Page

 

 

Pre-Trip Email 1

Attractions Pre-Trip Email v1

 

Pre-Trip Email 2

Attractions Pre-Trip Email v2

 

 

Pre-Trip Email 3

Attractions pre-trip email v3