GetYourGuide integration

Blanca Castillo
Blanca Castillo
  • Updated

What is GetYourGuide?

GetYourGuide is a global online marketplace for tours, activities, and attractions. Travelers use GetYourGuide to:

  • Discover things to do in destinations around the world

  • Compare different operators and experiences

  • Book instantly and receive mobile tickets or vouchers

As a tour operator using TourCMS, you can list your products on GetYourGuide and receive bookings directly into your TourCMS account via our integration.

Why connect TourCMS with GetYourGuide?

Connect your TourCMS account to GetYourGuide to sell your tours and activities to millions of travelers worldwide. This page is your starting point to understand what GetYourGuide is, why the connection matters for you as a tour operator, and where to find all detailed setup guides.

Integrating TourCMS with GetYourGuide brings several key benefits:

  • Reach more customers
    Access GetYourGuide’s large international customer base without building your own global marketing presence.

  • Real-time availability & pricing
    GetYourGuide pulls availability, pricing, and product details directly from TourCMS, helping you avoid overbookings and manual updates.

  • Automatic booking import
    Bookings generated on GetYourGuide are sent straight into TourCMS, reducing manual data entry and errors.

  • Centralized operations
    Manage your inventory, schedules, and capacity in one place (TourCMS), while multiple sales channels – including GetYourGuide – sell your products.

  • Better control over distribution
    Decide which products, rates, and dates you offer on GetYourGuide, and keep them aligned with your other channels.

 

What should I do?

Before you start

  1. Make sure you have a commercial agreement with Viator (or are in the process of becoming a Viator supplier).

  2. Set up your products on the GetYourGuide supplier portal (product content, schedules & prices, tickets, etc.).

  3. Decide which TourCMS channel you want GetYourGuide bookings to route through (this affects the tour list, pricing, and how bookings are received).

If you are unsure about any of these points, contact our team here and we can review your setup.

How do I get started?

To help you step through the connection, we’ve organized more detailed articles below this page. Use them in order when setting up the integration, or jump to the topic you need:

  • Introduction & requirements
    Learn what you need before you connect (contracts, API credentials, channel configuration, etc.).

  • Connecting TourCMS with GetYourGuide and mapping
    Step‑by‑step instructions to link your TourCMS account to your GetYourGuide supplier account.
    How to map your TourCMS products, options, and rate plans to your GetYourGuide products.

  • GetYourGuide features

How to set up various GetYourGuide features already implemented in TourCMS.

How to set up capacity by rate for GetYourGuide availability

Managing Promotions in TourCMS

How the integration behaves day‑to‑day

Availability and dates

  • GetYourGuide reads real‑time availability from TourCMS when customers search and book.

  • When you open or close dates/times in TourCMS, those changes are reflected on GetYourGuide the next time they request availability.

  • If you use capacity‑by‑rate or more advanced availability setups, GetYourGuide will only be able to sell what the TourCMS API reports as available for that specific rate / option.
    How to set up capacity by rate for GetYourGuide availability

Prices

  • If GetYourGuide is configured to take prices via TourCMS API, then:

    • The price shown to the customer on GetYourGuide comes from your TourCMS prices for that product / option / rate / date.

    • When you change a price in TourCMS, GetYourGuide uses the new value on the next availability/price request.

  • If GetYourGuide is instead using their own catalogue pricing, then TourCMS availability still applies, but prices may differ and must be adjusted in the GYG extranet. See pricing behaviour notes here: How to set up capacity by rate for GetYourGuide availability

Bookings and changes

  • When a customer confirms a booking on GetYourGuide, the integration:

    • Sends a real‑time booking request to TourCMS.

    • Creates a booking against the mapped TourCMS product / departure / rate.

    • Returns confirmation details back to GetYourGuide.

  • In normal conditions, you should see the new booking within a few seconds in TourCMS.

  • If the exact departure, option or rate is missing or closed in TourCMS, the booking may fail or not appear, even if it looked bookable on GetYourGuide. In that case, first check the mapping guide and your schedules:
    👉 GetYourGuide mapping

Cancellations

  • When GetYourGuide cancels a booking via API, TourCMS receives the cancellation and:

    • Marks the booking as cancelled.

    • Frees up the capacity (subject to your product settings).

  • A booking cancelled directly in TourCMS does not automatically cancel on GetYourGuide.

    • To cancel for the customer and trigger the correct refund, you must process the cancellation in GetYourGuide according to their rules/policies.

Pickups and customer details

  • GetYourGuide sends the customer contact details and answers to standard questions (e.g. language, special requirements) into TourCMS where supported by the API.

  • Pickup information generally arrives in TourCMS as free‑text notes or answers to questions, not as a pre‑mapped pickup route and time.

    • You may still need to manually review pickup details and confirm the exact pickup time / location with the customer where required by your operation.

       

Troubleshooting and diagnostics

If you still cannot resolve the issue after going through the relevant guide, contact Support via:
Submit a request – TourCMS

  • Include as much detail as possible, for example:

  • TourCMS Account ID and Tour ID

  • The GetYourGuide booking reference

  • Screenshots from TourCMS and the GetYourGuide supplier portal (especially product setup, availability, and pricing)

  • A description of what you expected vs. what you are seeing (wrong availability, wrong price, missing product, etc.).

     

FAQs

➕ Do I need a GetYourGuide contract before connecting TourCMS?

Yes. You need an active supplier account and contract with GetYourGuide before you can connect TourCMS. Once that is in place, follow the connection and mapping steps here:

How to register for a GetYourGuide account

How to provide us access to your GetYourGuide portal

➕ Which products can I sell on GetYourGuide through TourCMS?

You can sell any public, bookable TourCMS products that are properly mapped to a GetYourGuide product/option using the External product ID. Details on how to map products are here:

GetYourGuide mapping

➕ How often are availability and prices updated on GetYourGuide?

GetYourGuide pulls availability and prices from TourCMS in real time during search and booking. If you change dates, capacity, or prices in TourCMS, they are used on the next availability/price check. For capacity-by-rate setups, see:

How to set up capacity by rate for GetYourGuide availability

➕ How long does it take for bookings to appear in TourCMS?

Bookings are sent from GetYourGuide to TourCMS immediately after confirmation. In normal conditions you should see the booking in TourCMS within a few seconds. If a specific booking is missing, start with the mapping troubleshooting:

GetYourGuide mapping

➕ Why are prices on GetYourGuide different from TourCMS?

Differences usually come from how GetYourGuide is configured to take prices (via TourCMS API or via their own catalogue). Check your base prices and currency in TourCMS and review the pricing behaviour.

➕ What is the External product ID and why is it important?

The External product ID is the mapping code that tells GetYourGuide which TourCMS product (and departures) to use. If it is wrong or incomplete, products may not appear, bookings may fail, or availability may not match. See the full mapping rules here:

GetYourGuide mapping

➕ Are there any cut-off time limits for selling on GetYourGuide?

Yes. GetYourGuide only sells products that meet their cut-off requirements (for example, bookings often need to be allowed up to less than 24 hours before departure). If your TourCMS cut-offs are too long, close-in availability may not be offered on GetYourGuide.