Technical Explainer

How Fare Construction Works

A step-by-step breakdown of how two AI systems work together to find dramatically cheaper Business Class fares.

The Two Engines Under the Hood

Every search uses both systems in a tight feedback loop.

๐Ÿค– Claude AI
Anthropic ยท Intelligence Layer
  • โ–ธSelects which airports to try as throwaway segments (understands geography & direction of travel)
  • โ–ธDecides which seasons to avoid for extra segments
  • โ–ธRanks and validates all found itineraries cheapest โ†’ most expensive
  • โ–ธExplains in plain English WHY each construction is cheaper
  • โ–ธProcesses user feedback into actionable search rules
  • โ–ธAuto-tags and summarizes bug reports & feature requests
  • โ–ธSynthesizes community suggestions into live prompt rules
โœˆ๏ธ Amadeus API
Real-time GDS Data ยท Source of Truth
  • โ–ธFetch baseline Business Class nonstop price (GET /v2/shopping/flight-offers)
  • โ–ธGet all direct destinations from arrival airport (GET /v1/airport/direct-destinations)
  • โ–ธFind cheapest destinations from a given airport (GET /v1/shopping/flight-destinations)
  • โ–ธRun all multi-city fare constructions โ€” 2 & 3-segment (POST /v2/shopping/flight-offers)
  • โ–ธFind cheapest dates for the return throwaway leg (GET /v1/shopping/flight-dates)
  • โ–ธAirport autocomplete search (GET /v1/reference-data/locations)

Why Both?

Amadeus gives us real, bookable prices from the GDS โ€” it's the source of truth. Claude gives us the intelligence to know which prices to look for. Neither alone would work: Amadeus without AI would search randomly across thousands of airports; AI without Amadeus would just guess prices. Together, they run a targeted, intelligent search in under 60 seconds.

The Search Flow โ€” Step by Step

Exactly what happens after you click "Find Cheaper Business Class".

1
๐Ÿ”ต AmadeusGET /v2/shopping/flight-offers

Fetch baseline nonstop Business Class price for your route

2
๐Ÿ”ต AmadeusGET /v2/shopping/flight-offers ร—8

Round-trip searches โ€” 8 return date variants (+3, +7, +14, +30, +60, +90, +180, +270 days) compared vs one-way baseline

3
๐ŸŸฃ Claude AIclaude-sonnet

Select the 15 best candidate throwaway airports (geography, region, season, community rules)

4
๐Ÿ”ต AmadeusPOST /v2/shopping/flight-offers ร—15

Run 2-segment multi-city searches (your route + throwaway segment) across all candidates

5
๐Ÿ”ต AmadeusPOST /v2/shopping/flight-offers

3-segment constructions โ€” destination-region candidates (Rule 11)

6
๐Ÿ”ต AmadeusPOST /v2/shopping/flight-offers

3-segment wide constructions โ€” cross-region candidates (Rule 12)

7
๐ŸŸฃ Claude AIclaude-sonnet

Rank all results across all construction types, validate fare rules, calculate savings %, write plain-English explanations

โœ… Results

Cheapest valid constructions displayed with booking links

Data Freshness

Flight prices
Real-time from Amadeus GDS โ€” updated every search
Airport routes
Cached 24 hours โ€” changes rarely, served instantly
AI candidate selection
Per search โ€” uses latest community rules each time
Your feedback & suggestions
Applied immediately โ€” shapes the next search