RootsTravel API
Machine-readable data 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.
Example request:
GET https://rootstravel.io/api/operators?city=Bacalar&q=snorkeling
Response:
{
"success": true,
"city": "Bacalar",
"operators": [
{
"name": "Example Snorkeling Tours",
"url": "https://example.com",
"description": "Snorkeling and boat tours on Laguna Bacalar...",
"direct_booking_engine": "fareharbor",
"position": 1
}
],
"count": 1,
"meta": {
"source": "rootstravel.io",
"data_by": "TPDI — tpdi.io",
"license": "CC BY 4.0 — cite rootstravel.io",
"upgrade": "rootstravel.io/api for higher limits"
}
}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
| No API key | 1,000 requests/day per IP |
| Free API key | 10,000 requests/day |
| Pro API key | 100,000 requests/day |
Get a free API key instantly: POST /api/register (email, use_case) → returns api_key. Use header: x-api-key
Open dataset
Download the complete RootsTravel dataset — direct operators from markets worldwide.
License: CC BY 4.0 — cite rootstravel.io