Google Flights MCP, CLI and Python Library
#!/usr/bin/env python3
"""Multi-city flight search example.
CURRENTLY UNAVAILABLE. Since 2026-08 searches are served by Google's
public ``/travel/flights`` page rather than the ``GetShoppingResults``
RPC, which now requires a browser-signed header. Google loads multi-city
results client-side through that same gated RPC, so the page carries no
flight rows to read — :meth:`SearchFlights.search` raises
``SearchUnsupportedError`` rather than returning the first leg's one-way
board, which would decode cleanly into wrong results. Search each leg
separately for now. This example is kept for when that changes; see
github.com/punitarani/fli#223.
This example demonstrates how to search a multi-city itinerary (three or
more one-way legs on different dates) in a single request. Multi-city
results come back as tuples of ``FlightResult`` — one entry per leg, in
the order the legs were supplied.
"""
from datetime import datetime, timedelta
from fli.models import (
Airport,
FlightSearchFilters,
FlightSegment,
PassengerInfo,
SeatType,
TripType,
)
from fli.search import SearchFlights
def main():
base = datetime.now() + timedelta(days=30)
def leg(origin: Airport, destination: Airport, day_offset: int) -> FlightSegment:
return FlightSegment(
departure_airport=[[origin, 0]],
arrival_airport=[[destination, 0]],
travel_date=(base + timedelta(days=day_offset)).strftime("%Y-%m-%d"),
)
# JFK -> LHR, a few days in London, LHR -> CDG, then CDG -> JFK home.
filters = FlightSearchFilters(
trip_type=TripType.MULTI_CITY,
passenger_info=PassengerInfo(adults=1),
flight_segments=[
leg(Airport.JFK, Airport.LHR, 0),
leg(Airport.LHR, Airport.CDG, 4),
leg(Airport.CDG, Airport.JFK, 7),
],
seat_type=SeatType.ECONOMY,
)
search = SearchFlights()
# top_n controls how many outbound options each leg is expanded against.
itineraries = search.search(filters, top_n=3)
if not itineraries:
print("No itineraries found.")
return
print(f"Found {len(itineraries)} multi-city itineraries:\n")
for i, legs in enumerate(itineraries, 1):
total = sum(segment.price for segment in legs)
print(f"--- Itinerary {i} — total ${total:.0f} ---")
for segment in legs:
first, last = segment.legs[0], segment.legs[-1]
print(
f" {first.departure_airport.value} -> {last.arrival_airport.value}"
f" ${segment.price:.0f} {segment.duration} min {segment.stops} stop(s)"
)
print()
if __name__ == "__main__":
main()