Search capabilities
One-way flights
Search direct and connecting flights between any two airports
Round-trip flights
Two-step booking flow: select outbound, then view return options
Multi-city trips
Chain up to 6 flight legs for complex itineraries
Flight status lookup
Real-time flight information by number and date
How flight search works
One-way and round-trip
Search for flights using IATA airport codes. The platform fetches results from Google Flights via SerpAPI. Request example:Round-trip searches use a two-step flow: first select an outbound flight, then the platform fetches return options using the
departureToken from your selected outbound offer.Multi-city search
Build complex itineraries with up to 6 legs. Each leg requires origin, destination, and departure date.Flight status tracking
Look up live flight information by flight number and departure date. The platform checks AeroAPI (FlightAware) and falls back to Aviationstack. Endpoint:POST /api/flights/status
Request:
Filtering and sorting results
The flights UI includes:- Airline filter: Show only flights from a specific carrier
- Max price filter: Set an upper price limit
- Sortable columns: Route, date, departure time, arrival time, duration, stops, cost, airline
Booking options
For SerpAPI results with abookingToken, resolve the direct booking URL:
Endpoint: POST /api/flights/serp/booking-options
Request:
Most offers include a
bookUrl that links directly to Google Flights with the flight pre-selected. Use the booking-options endpoint when you need the exact POST data for programmatic booking.Saving flights to your trip
Each searched flight can be saved with:- Route (origin → destination)
- Departure and arrival times
- Duration and stops
- Airline and cost
- Booking URL
Explore mode
Find cheap flights from your origin to multiple destinations across a date range. Endpoint:POST /api/flights/serp/explore
Request:
Explore mode is limited to 14 dates and returns only the best offer per destination per date. Use this to find the most affordable travel window.
API configuration
Flight search requires:SERPAPI_API_KEY(orSERP_API_KEY) for search and booking optionsAERO_API_KEY(orAEROAPI_KEY) for status lookup (primary)FLIGHT_STATUS_API_KEY(orAVIATIONSTACK_API_KEY) for status lookup (fallback)