Getting Started

Getting Started

Make your first API call in under 5 minutes

Prerequisites

ETERA Account

Sign up at etera.tech for API access

API Key

Generate a key from the ETERA Dashboard

Base URLs

ETERA provides three environments. Use the environment selector in the API playground to switch between them.

EnvironmentBase URLPurpose
Productionhttps://api.etera.devLive traffic
Staginghttps://api-stage.etera.devPre-production validation
Developmenthttps://api-dev.etera.devTesting and development

Your First Request

1

Set up authentication

All requests require a Bearer token in the Authorization header:

$Authorization: Bearer YOUR_API_KEY
2

Search for restaurants

Let’s make a real API call to search for restaurant recommendations:

$curl -X GET "https://api.etera.dev/restaurant/search/recommendations/" \
>  -H "Authorization: Bearer YOUR_API_KEY" \
>  -H "Content-Type: application/json"
3

Explore the response

The API returns restaurant data with details like name, cuisine, location, ratings, and availability. You can use these results to display recommendations in your app.

URL Structure

All ETERA APIs follow a consistent URL pattern:

https://api.etera.dev/{vertical}/{service}/{endpoint}

Verticals: restaurant, experience, hotel, flight

Services per vertical: booking, search, data, mcp, agent

Try Different Verticals

Use CaseMethodEndpoint
Search restaurantsGET/restaurant/search/recommendations/
Create a bookingPOST/restaurant/booking/bookings/
Get restaurant dataGET/restaurant/data/
List MCP toolsGET/restaurant/mcp/mcp/tools
AI agent inputPOST/restaurant/agent/ai-input

Platform Services

These services operate at the root level (no vertical prefix):

ServiceBase PathDescription
Auth/authAuthentication (OTP, OAuth, JWT)
Account/accountUser profiles and settings
Payment/paymentStripe payment processing
Context/contextExplore, weather, city data
Notification/notificationPush and email notifications
AI/aiAI agent supervisor

Next Steps

Authentication

Set up OAuth and API keys

MCP Integration

Connect AI models to ETERA

Environments

Dev, staging, and production details

Error Handling

Error formats and retry strategies