ETERA API Documentation

Build with ETERA

ETERA powers travel and lifestyle applications with a unified API platform. Search, book, and manage travel experiences through a single consistent interface.

525+ Endpoints

Comprehensive coverage across all travel verticals

4 Verticals

Restaurant, Experience, Hotel, and Flight

26 Microservices

Purpose-built services with consistent patterns

3 Environments

Production, Staging, and Development

Quick Start

Get up and running in under 5 minutes:

Get your API key

Make your first request

curl https://api.etera.dev/restaurant/search/recommendations/ \
  -H "Authorization: Bearer YOUR_API_KEY"

Explore the API

Browse the reference tabs above to discover endpoints across all verticals.

Travel Verticals

Restaurant

Search 1M+ restaurants, manage bookings and reservations, AI-powered dining agents, and MCP tool integration for smart recommendations

Experience

Discover activities in 120+ destinations, book experiences instantly, search with AI recommendations, and manage experience catalogs

Hotels

Search 4M+ stays with hybrid/vector/text modes, manage booking lifecycles, property data management, and AI-powered hotel agents

Flights

Search 400+ carriers globally, pricing with fare options, airline data, booking lifecycle management, and AI-powered flight agents

Platform Services

Authentication

Phone OTP, email OTP, Google & Apple OAuth with JWT tokens

Account

User profiles, avatars, settings, likes, and booking history

Payments

Stripe-based payment processing, refunds, and customer management

AI Supervisor

AI-powered agent coordination, intent detection, and conversation management

Consistent Architecture

Every travel vertical follows the same 5-service architecture:

Service	Purpose	Example Endpoint
Search	Discovery & recommendations	`GET /restaurant/search/recommendations/`
Booking	Reservation lifecycle	`POST /hotel/booking/bookings/`
Data	Content & catalog management	`GET /flight/data/airlines/`
MCP	Model Context Protocol tools	`GET /experience/mcp/mcp/tools`
Agent	AI-powered automation	`POST /restaurant/agent/ai-input`

All endpoints follow the pattern: https://api.etera.dev/{vertical}/{service}/{endpoint}

Guides

Getting Started

Make your first API call in under 5 minutes

Authentication

Set up phone OTP, email, or OAuth authentication

MCP Integration

Connect AI models to ETERA via Model Context Protocol

SDKs & Examples

TypeScript, Python, and cURL code examples