Paiko Atlas

AI travel intelligence API for agents. Ingests travel data via tinyfish, scores and ranks options across price, timing, risk, and traveler fit, and returns structured decisions with explanations and confidence scores.

API surface

Endpoint	Status	Description
POST /v1/flights/decide	Live	Ranked flight options with reasoning
POST /v1/hotels/decide	Live	Ranked hotel options with reasoning
POST /v1/routes/decide	Scaffold	Multi-modal route comparison
POST /v1/places/decide	Scaffold	Ranked places by intent
POST /v1/trips/build	Scaffold	Structured trip candidates
POST /v1/compare	Scaffold	Best option with reasoning
POST /v1/risk	Live	Risk signals (delay, safety, health)
POST /v1/policy/check	Live	Visa, health, and advisory compliance

Raw tinyfish data endpoints available at /api/tinyfish/{flights,hotels,risk,rewards,visa,activities,weather}.

Architecture

tinyfish (source adapters) → atlas (score, rank, explain) → v1 API (agent-callable)

Source registry: src/lib/tinyfish/source-map.ts — typed source lists per route with APAC-first priority metadata.

Development

npm install
npm run dev     # Next.js dev server
npm run test    # vitest

Key directories

• src/app/api/v1/ — Atlas decision endpoints
• src/app/api/tinyfish/ — Raw data endpoints
• src/lib/atlas/ — Scoring, explanation, confidence, types
• src/lib/tinyfish/ — Source adapters, fetcher, source registry