TourScanner API

Unified Tours & Activities API providing search, live availability, and full booking lifecycle.

GitHub OpenAPI

Operations 15

GET /api/search/destinations Search cities and attractions by name #
GET /api/search/activities Search activities with filters, facets and ranking #
GET /api/search/product/{id} Full activity detail #
POST /api/availability/schedule Open dates and prices over a date range #
POST /api/availability/slots Live time slots and prices for one date #
POST /api/booking/options Ticket types, age bands, cancellation policy and booking questions #
POST /api/booking/hold Hold inventory with the supplier and create a Stripe checkout #
POST /api/booking/confirm Confirm a paid hold with the supplier #
POST /api/booking/status Live booking status #
POST /api/booking/cancel-quote Whether a booking can be cancelled, and the refund #
POST /api/booking/cancel Cancel a booking with the supplier and refund #
POST /api/booking/amend-quote Quote a change of date, time, ticket type or party #
POST /api/booking/amend Apply a quoted amendment #
POST /api/booking/reschedule Move a confirmed booking to a new date/time (supported suppliers) #
POST /api/ai/chat.json Hosted agent turn (non-streaming) #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/tourscanner-ai:tourscanner-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

tourscanner-ai-tourscanner-api-openapi.yml Raw ↑
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.


    **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 the API answers 401 `{ "error": "API_KEY_REQUIRED" }`.


    **Retries.** Booking writes accept an `Idempotency-Key` header: a retry with the same key and body replays the original response instead of booking twice.


    **Errors** carry `data.code` and `data.retryable`.


    **Rate limits.** Counted per API key in a fixed 60-second window. REST API: 3000 requests per minute. Calls that take a booking reference have their own buckets on top of that: `/api/booking/status`, `/cancel-quote` and `/amend-quote` 600 per minute; `/api/booking/confirm`, `/cancel`, `/amend` and `/reschedule` 120 per minute. MCP server: 120 per minute. Hosted agent (`/api/ai/chat` and `/api/ai/chat.json`): 20 per minute. Responses carry `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset` (Unix seconds); a 429 adds `Retry-After` (seconds) and `data.retryAfterSeconds`.


    **Agents.** An MCP server with the same capabilities is at `https://tourscanner.ai/api/mcp` (Streamable HTTP, same API key as `Authorization: Bearer`, `X-API-Key` or `?api_key=`). On the agent layer (MCP and /api/ai/chat), create_checkout_session returns the tourscanner.io checkout link where the traveller books and pays; cancel and amend run in demo mode. Live bookings through your own checkout go through the /api/booking endpoints below.


    **Changes.** Dated API changes are at https://tourscanner.ai/changelog.


    **Live environment.** This host is production: `/api/booking/hold` places a real supplier hold and a real Stripe checkout. Contact api@tourscanner.ai for sandbox access.'
  termsOfService: https://tourscanner.ai/terms
  contact:
    name: TourScanner API
    email: api@tourscanner.ai
    url: https://tourscanner.ai/docs
servers:
- url: https://tourscanner.ai
security:
- ApiKeyAuth: []
tags:
- name: Search
  description: Destinations and activity catalog
- name: Availability
  description: Live slots and prices from suppliers
- name: Booking
  description: Hold, confirm, status, cancel, amend


# --- truncated at 32 KB (47 KB total) ---
# Full source: https://artifacts.apis.io/tourscanner-ai/openapi/tourscanner-ai-tourscanner-api-openapi.yml