llms.txt Content
# TourScanner AI — Tours & Activities Booking API
> The largest multi-provider tours & activities API on the market.
> 1,000,000+ activities from 14 providers through a single REST API.
> Backed by TourScanner, with 10 years of experience in the tours & activities industry.
## Why TourScanner AI
- **One integration, all providers** — Search and book across 14 providers
- **1,000,000+ activities** across 5,000+ cities and 7,800+ attractions worldwide
- **API key access** — Keys are issued by TourScanner on request (api@tourscanner.ai); every REST and MCP call needs one
- **Full booking lifecycle** — Hold, pay, confirm, status, cancel and amend through the API
- **Agent-ready** — Remote MCP server, OpenAPI 3.1 spec, idempotent booking writes, machine-readable error codes
- **8 languages** — Full multilingual search and content (EN, IT, ES, FR, DE, PT, NL, PL)
- **Activity Caliber** — Proprietary quality-ranking algorithm refined over 10 years of data
## Who Is This For
- **Travel app developers** — Add tour booking to your app with a single API integration
- **AI agent builders** — Give your agent live search, availability and booking tools via MCP or REST
- **Affiliate & content sites** — Monetize your travel audience with real-time bookable activities
- **Tour operators & resellers** — Access the widest inventory through one API
## Booking Workflow
1. **Search** — Find cities and activities (`GET /api/search/destinations`, `GET /api/search/activities`)
2. **Availability** — Check dates and time slots (`POST /api/availability/schedule`, `POST /api/availability/slots`)
3. **Hold & Pay** — Reserve booking + Stripe checkout (`POST /api/booking/hold`)
4. **Confirm** — Finalize after payment (`POST /api/booking/confirm`)
5. **Manage** — Status, cancel and amend (`POST /api/booking/status`, `/cancel-quote`, `/cancel`, `/amend-quote`, `/amend`)
## Endpoints
- `GET /api/search/destinations?q=rome&lang=en` — Search cities
- `GET /api
OpenAPI Spec (preview)
{"openapi":"3.1.0","info":{"title":"TourScanner Tours & Activities API","version":"1.0.0","description":"One API for ~1M tours, tickets and experiences from 14 suppliers: search, live availability, and the full booking lifecycle (hold → pay → confirm → status → cancel / amend) with TourScanner as merchant of record on certified suppliers.\n\n**Auth.** Every endpoint needs an API key, sent as `X-API-Key`. Keys are issued by TourScanner on request: contact api@tourscanner.ai. Without one t