Search Viator's tours and activities inventory, confirm live availability/pricing, and complete a booking through the Viator Partner API v2.
domain: viator.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Apply for Viator Partner API access (affiliate or merchant tier) through Viator's onboarding team and obtain an API key.
Call the products search endpoint with destination, category, and attraction filters to retrieve matching products.
Call the availability schedules endpoint for the chosen product to confirm live time slots and pricing, sending your key in the exp-api-key header on every request (avoid the bulk product/availability variants for real-time lookups — they're documented as not for real-time/ingestion use).
Call the cart-hold booking endpoint to place an inventory and/or pricing hold on the selected option before your customer finishes checkout.
Call the cart-book endpoint, passing the booking reference returned from the hold step plus traveler and communication details, to confirm the reservation.
Complete Viator's back-end API certification checks on your integration before enabling real bookings.
Known gotchas
Skipping the hold step and calling book directly risks price changes or failed confirmations — if you use the cart-hold endpoint, you must carry its booking reference into cart-book or a new (unheld) booking attempt is made instead.
Access level gates functionality: affiliate partners with full booking access are required to use the cart endpoints rather than single-item booking endpoints, and merchant vs. affiliate partners have separate technical doc sets.
The bulk products/availability endpoints are explicitly documented as unsuitable for real-time queries or ingestion — using them that way violates their intended use pattern.
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?