Back to the knowledge base
Distribution

Connect your products to GetYourGuide

Ticketjoy connects through the official GetYourGuide Live API. As a supplier you only need your Supplier ID and one Product ID per product option.

5 min read

TicketJoy connects to GetYourGuide through the official Live API (real-time availability and booking). The technical connection is managed by TicketJoy on the platform level, so as a supplier you only need two things: your Supplier ID and one Product ID per GetYourGuide product option.

Step 1 — Enable the integration in TicketJoy and obtain your Product IDs

  1. 1Log in to TicketJoy and open Distribution in the left-hand menu (portal.ticketjoy.app → your organisation → Distribution).
  2. 2Click Connect channel and choose GetYourGuide · Live API.
  3. 3Give the channel a name, set your GetYourGuide commission and click Create.
  4. 4Open Connection details on the new channel and note your Supplier ID — GetYourGuide uses it once when they activate your connection.
  5. 5Link your products: at the bottom of the channel card, select the TicketJoy item you sell on GetYourGuide and choose the slot strategy. TicketJoy fills in a Product ID for you (a short code based on the item name, e.g. CANAL-CRUISE-90) — keep it or type your own — and click Link. Repeat for every GetYourGuide product option; several options may point to the same TicketJoy item, each with its own Product ID.
  6. 6Open a linked product row and map the GetYourGuide ticket categories (ADULT, CHILD, YOUTH, SENIOR, …) to your own ticket tiers. `ADULT` is required — TicketJoy warns you on the product row as long as it is missing, and GetYourGuide cannot sell the product without it.

Where do I find my Product IDs? Your Product IDs are shown on the Distribution page: every linked product row displays its Product ID next to the item name (open the row to view or change it). If a row shows no Product ID, TicketJoy falls back to the item's own numeric ID, which you can also use. Copy these values exactly as shown — this is what you enter on GetYourGuide.

Not sure which item belongs to which GetYourGuide product? Contact support@ticketjoy.app and we will map them with you.

Step 2 — Connect your products on GetYourGuide

  1. 1Log in to your GetYourGuide Supplier Administration account.
  2. 2Open Edit product and select the product option you want to connect.
  3. 3Under "Do you use an online reservation system?" choose Yes, I use a reservation system.
  4. 4In Select your Reservation System, choose TicketJoy.
  5. 5In External product ID, enter the Product ID of the matching product in TicketJoy (Step 1) and save.
  6. 6Repeat for every product option.

Once mapping is confirmed, GetYourGuide checks availability directly in TicketJoy and bookings, changes and cancellations arrive in your TicketJoy order list in real time.

Good to know

  • Availability: GetYourGuide reads the live capacity of your TicketJoy time slots. Closing a slot in TicketJoy immediately closes it on GetYourGuide.
  • Pricing: rates come from your TicketJoy ticket tiers; the commission you set on the channel is used for reporting and payouts.
  • Past bookings: existing GetYourGuide bookings can be imported once from a GetYourGuide bookings export via Import bookings on the channel card.

Support

TicketJoy: support@ticketjoy.app