Python library overview

pip install fli

from datetime import datetime, timedelta
from fli.models import (
    Airport,
    FlightSearchFilters,
    FlightSegment,
    PassengerInfo,
    SeatType,
    MaxStops,
)
from fli.search import SearchFlights

# Create search filters
filters = FlightSearchFilters(
    passenger_info=PassengerInfo(adults=1),
    flight_segments=[
        FlightSegment(
            departure_airport=[[Airport.JFK, 0]],
            arrival_airport=[[Airport.LAX, 0]],
            travel_date=(datetime.now() + timedelta(days=30)).strftime("%Y-%m-%d"),
        )
    ],
    seat_type=SeatType.ECONOMY,
    stops=MaxStops.NON_STOP,
)

# Search flights
search = SearchFlights()
flights = search.search(filters)

# Process results
for flight in flights:
    print(f"Price: ${flight.price}")
    print(f"Duration: {flight.duration} minutes")
    for leg in flight.legs:
        print(f"Flight: {leg.airline.value} {leg.flight_number}")
        print(f"From: {leg.departure_airport.value} at {leg.departure_datetime}")
        print(f"To: {leg.arrival_airport.value} at {leg.arrival_datetime}")

FlightSearchFilters(
    trip_type=TripType.ONE_WAY,           # or ROUND_TRIP
    passenger_info=PassengerInfo(adults=1),
    flight_segments=[...],                 # List of FlightSegment
    seat_type=SeatType.ECONOMY,           # Cabin class
    stops=MaxStops.NON_STOP,              # Stop preferences
    airlines=[Airline.AA, Airline.DL],    # Optional airline filter
    max_duration=720,                      # Max flight time in minutes
    sort_by=SortBy.CHEAPEST,              # Sort preference
)

DateSearchFilters(
    trip_type=TripType.ONE_WAY,
    passenger_info=PassengerInfo(adults=1),
    flight_segments=[...],
    from_date="2024-06-01",               # Start of date range
    to_date="2024-06-30",                 # End of date range
    duration=7,                            # Round trip duration (days)
    seat_type=SeatType.ECONOMY,
    stops=MaxStops.ANY,
)

FlightSegment(
    departure_airport=[[Airport.JFK, 0]],
    arrival_airport=[[Airport.LAX, 0]],
    travel_date="2024-06-15",
    time_restrictions=TimeRestrictions(
        earliest_departure=6,              # 6 AM
        latest_departure=12,               # 12 PM
    ),
)

class FlightResult:
    price: float                           # Total price
    duration: int                          # Total duration (minutes)
    stops: int                             # Number of stops
    legs: list[FlightLeg]                  # Individual flight legs

class FlightLeg:
    airline: Airline                       # Airline enum
    flight_number: str                     # Flight number
    departure_airport: Airport             # Origin airport
    arrival_airport: Airport               # Destination airport
    departure_datetime: datetime           # Departure time
    arrival_datetime: datetime             # Arrival time
    duration: int                          # Leg duration (minutes)

class DatePrice:
    date: tuple[datetime] | tuple[datetime, datetime]  # One-way or round-trip dates
    price: float                           # Flight price

from fli.models import Airport

# Major US airports
Airport.JFK  # New York JFK
Airport.LAX  # Los Angeles
Airport.ORD  # Chicago O'Hare
Airport.SFO  # San Francisco

# International airports
Airport.LHR  # London Heathrow
Airport.CDG  # Paris Charles de Gaulle
Airport.NRT  # Tokyo Narita

from fli.models import Airline

Airline.AA   # American Airlines
Airline.DL   # Delta
Airline.UA   # United
Airline.BA   # British Airways

from fli.models import SeatType

SeatType.ECONOMY
SeatType.PREMIUM_ECONOMY
SeatType.BUSINESS
SeatType.FIRST

from fli.models import MaxStops

MaxStops.NON_STOP
MaxStops.ONE_STOP_OR_FEWER
MaxStops.TWO_PLUS_STOPS
MaxStops.ANY

from fli.models import SortBy

SortBy.CHEAPEST
SortBy.DURATION
SortBy.DEPARTURE_TIME
SortBy.ARRIVAL_TIME

try:
    results = search.search(filters)
    if not results:
        print("No flights found")
except Exception as e:
    print(f"Search failed: {e}")