GetYourGuide supports API connections at the option level, allowing you to tailor your system to specific use cases and offer customers a seamless experience.
Overview: Activities Structure on GetYourGuide
Activities are organized into two levels: Tours and Tour Options.
Tour
A Tour is a general product that represents an experience or activity available for booking.
It contains descriptive and logistical information such as:
- Activity description
- Location
- Highlights and inclusions
Important: A Tour itself is not bookable. It serves as the parent structure for one or more Tour Options.
Tour Option
A Tour Option is the bookable unit within a Tour.
Each option includes essential details required for booking:
- Availability
- Pricing
- Booking conditions
Requirements for Tour Options
For an option to be available for sale via API, it must include:
- Availability
- Pricing
Options under the same Tour can vary by features such as:
- Meal inclusion (e.g., with or without lunch)
- Availability of services (e.g., audioguides)
- Different pickup locations or durations
- Guide language
Because of these variations, each option must have its own pricing and availability defined.
Start Times vs. Opening Hours
Each Tour Option can include both:
-
Start times – When a specific activity begins (e.g., 10:00 AM).
In our documentation, this is referred to as a Time Point. -
Opening hours – The window during which a venue or service is accessible (e.g., 09:00–17:00). This will give the customers the freedom to arrive at anytime between the beginning and the end of the activity.
In our documentation, this is referred to as a Time Period.
These fields are critical for managing availability and setting accurate expectations for customers.
Price Categories
Each option can support multiple price categories, each with unique:
- Price structure
- Age range
- Participant requirements
Important: Price categories must always refer to individuals (e.g., adult, child). Group-level categories should follow specific guidelines.
Learn more about permitted price categories
Review best practices for using the GROUP category
Next Steps
For implementation details, refer to the API Documentation. Ensuring your system supports this structure will lead to a better-integrated and more user-friendly experience.