Authenticate to the GetYourGuide Partner API using HMAC-signed requests with your partner access ID and secret as documented in their partner portal.
Search for tours at a destination by querying the tours/search endpoint with cnt_language, q (destination or keyword), and date filters for availability.
Fetch the full tour details by ID to obtain pricing tiers, duration, meeting point, inclusions, and category tags.
Check availability for a specific date and participant count using the tour availability endpoint; the response includes option IDs (time slots) with their prices and remaining capacity.
Book by calling the booking creation endpoint with tour ID, option ID, date, participant details, and payment reference; store the GetYourGuide booking reference and retrieve the voucher URL.
Handle cancellations through the cancellation endpoint using the booking reference, respecting the refundable_until timestamp in the booking response.
Known gotchas
GetYourGuide's partner API access requires a formal commercial agreement and is not a self-serve sign-up; ensure partnership is established before building integration.
Activity availability is cached and can go stale quickly for popular tours; always perform a live availability check within the checkout flow, not at search time.
The voucher must be presented at the activity (QR code or printed); ensure your post-booking email includes the voucher in a mobile-friendly format.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp