fast-flights Python Library

To perform a flight search, use create_query to define your flight legs, passenger details, and trip type, then pass the resulting query to get_flights.

from fast_flights import (
    FlightQuery,
    Passengers, 
    create_query, 
    get_flights
)

query = create_query(
    flights=[
        FlightQuery(
            date="YYYY-MM-DD",   # change the date
            from_airport="MYJ",  # three-letter name
            to_airport="TPE",    # three-letter name
        ),
    ],
    seat="economy",  # business/economy/first/premium-economy
    trip="one-way",  # multi-city/one-way/round-trip
    passengers=Passengers(adults=1),
    language="zh-TW",
)
res = get_flights(query)

Install the fast-flights library using pip to access the strongly-typed Google Flights scraper API.

$ pip install fast-flights

You can programmatically build a flight search query using create_query(). This function accepts a list of FlightQuery objects for flight legs and several global parameters like seat, trip, passengers, and language that apply to the entire search.

To execute the search, pass the resulting query object to get_flights().

from fast_flights import (
    FlightQuery,
    Passengers,
    create_query
)

query = create_query(
    flights=[
        FlightQuery(
            date="2067-06-07",
            from_airport="MYJ",
            to_airport="TPE"
        ),
    ],
    seat="economy",
    trip="one-way",
    passengers=Passengers(adults=1, infants_in_seat=2),
    language="en"
)

# res = get_flights(query)

The create_query() function supports several parameters that apply to the entire search result rather than individual legs:

• currency: The currency code for pricing (e.g., "USD").
• max_price: Maximum price allowed, using the selected currency.
• carry_on_bags: Number of carry-on bags to include.
• checked_bags: Number of checked bags to include (includes estimated fees in displayed prices).
• hide_separate_and_self_transfer: Boolean to hide non-through flights.
• exclude_basic_economy: Boolean to exclude basic economy fares.

query = create_query(
    flights=[data],
    currency="USD",
    max_price=1500,
    carry_on_bags=1,
    checked_bags=1,
    hide_separate_and_self_transfer=True,
    exclude_basic_economy=True,
)

For improved consistency and access to richer data (like price insights and booking options), use the SearchApi integration. The returned result will be a SearchApiResult object.

SearchApiResult available fields:

• flights
• cheaper_alternatives
• price_insights
• booking_options

from fast_flights.integrations import SearchApi, SearchApiResult

result: SearchApiResult = get_flights(
    ...,
    integration=SearchApi()
)

# Access rich data
print(result.flights)
print(result.cheaper_alternatives)
print(result.price_insights)
print(result.booking_options)

from fast_flights.integrations import SearchApi, SearchApiResult

result: SearchApiResult = get_flights(
    ...,
    integration=SearchApi()
)

# rich data!
result.flights
result.cheaper_alternatives
result.price_insights
result.booking_options

Instead of using create_query(), you can pass a natural language string directly to get_flights() to perform a search.

get_flights(
    "Flights from TPE to MYJ on 2067-06-07 one way economy class"
)

To protect your IP during scraping, you can use the BrightData integration by passing it to the integration parameter in get_flights.

from fast_flights.integrations import BrightData

result = get_flights(
    ..., 
    integration=BrightData(zone="...")
)

Use the Passengers class to specify the number of travelers.

Constraints:

• The total sum of adults, children, infants_in_seat, and infants_on_lap must not exceed 9.
• You must have at least one adult for every infant on lap (infants_on_lap).

passengers = Passengers(
    adults=2,
    children=1,
    infants_in_seat=0,
    infants_on_lap=0
)

Once a query is created, you can serialize it for transmission or storage using to_bytes() or to_str().

query: Query = create_query(
    flight_data=[
        FlightQuery(
            date="2025-01-01",
            from_airport="TPE",
            to_airport="MYJ",
        )
    ],
    trip="round-trip",
    passengers=Passengers(adults=2, children=1, infants_in_seat=0, infants_on_lap=0),
    seat="economy",
    max_stops=1,
)

query.to_bytes()  # Base64-encoded (bytes)
query.to_str()  # Serialize to string