RootsTravel API

A global index of direct-booking travel operators.
Machine-readable for AI agents and developers.

For AI agents

RootsTravel provides structured data about direct booking operators worldwide. No OTAs. No intermediaries. Real operators, verified direct booking. An API key is required on every request (free — get one here).

Example request:

curl -H "x-api-key: YOUR_KEY" \
  "https://rootstravel.io/api/operators?city=Delhi&country=India"

Response:

{
  "success": true,
  "city": "Delhi",
  "operators": [
    {
      "name": "Example Tour Operator",
      "url": "https://example.com",
      "description": "Guided experiences in Delhi...",
      "direct_booking_engine": null,
      "position": 1
    }
  ],
  "count": 1,
  "meta": {
    "source": "rootstravel.io",
    "data_by": "TPDI — tpdi.io",
    "license": "CC BY 4.0 — cite rootstravel.io",
    "upgrade": "rootstravel.io/contact — ask for higher volume"
  }
}

For developers

Query parameters

Param	Required	Description
city	yes	City name
country	no	Country filter
activity	no	Accommodation, Guided Experience, Signature Local Activity
criteria	no	Luxury, Budget, Private, etc.
q	no	Text search in name and description. Fallback: if 0 results, returns all operators for city.

Rate limits

Every call must include a valid x-api-key so usage is tied to your key.

Free API key

10,000 requests/day

Need a higher limit? Contact us— we’ll see what we can do.

Get a free API key

We verify your email first. You receive a link; after you open it, your key is shown once — copy it right away.

Request a key — web form

Or use the HTTP API directly (same flow):

POST https://rootstravel.io/api/register with JSON { "email": "you@example.com", "use_case": "…" }— we send the confirmation email.
Open the link in the email, or call POST https://rootstravel.io/api/register/confirm with { "token": "…" } (token from the link). Response includes api_key.
Call GET /api/operators?city=… with header x-api-key: rs_…

Each successful response includes X-RateLimit-Remaining.

Open dataset

Download the complete RootsTravel dataset — direct operators from 273 markets in 31 countries.

Download JSON Download CSV Hugging Face

License: CC BY 4.0 — cite rootstravel.io

JSON and CSV: always up to date (fetched live). Hugging Face: synced weekly (Mondays).