Skip to main content

Google Flights Scraper ✈️

Fast flight data scraper from Google Flights which fetches and decodes flight information based on user's filters. Based on a Base64-encoded Protobuf URL string.

Features

  • 🔎 Search: Searching for airport and airlines IATA codes (2-letter and 3-letter location code respectively)
  • 🏷️ Filter Creation: Define custom filters for flights ( departure/arrival airports, airlines, dates, trip type, passengers, seat type, and maximum stops)
  • ⚙️ Data Fetching: Fetch flight data from Google Flights using either JavaScript-based parsing or local HTML parsing.
  • 🔓 Decoding: Decode the fetched flight data into structured objects for easy processing.

Installation

  pip install google-flight

or if you want to run it local (with Playwright):

  pip install google-flight[local]

Usage/Examples

  1. Create a Filter
  • Define the search criteria for flights using the create_filter (for ?tfs=) to perform a request. Then, add flight_data, trip, seat, and passengers to use the API directly.
from google_flights import create_filter, Passengers, FlightData, search_airline, search_airport

flight_filter = create_filter(
    flight_data=[
        FlightData(
            airlines=search_airline("RyanAir"),  # Airline codes - "FR" and "RK" - can be passed as list ["FR","RK"]
            date="2025-07-20",      # Date of departure
            from_airport=search_airport("Kaunas")  # Departure airport ["KUNs"]
            to_airport=["MAD"],  # Arrival airports
        ),
    ],
    trip="one-way",  # Trip type
    passengers=Passengers(adults=1, children=0, infants_in_seat=0, infants_on_lap=0),
    seat="economy",  # Seat type
    max_stops=1,     # Maximum number of stops
)
  1. Fetch Flight Data
  • Fetch flight data using the get_flights_from_filter
from google_flights import get_flights_from_filter

flight_data = get_flights_from_filter(flight_filter, data_source='js', mode="common")
  1. Result
  • The following parameters would be included in the API result:

✈️ Airline (code & name)

🔢 Flight number

🛫 Departure airport (code & name) & departure time

🛬 Arrival airport (code & name) & arrival time

📅 Departure date

⏱️ Travel duration

🛡️ Aircraft type

💺 Seat class (including seat pitch)

🌱 CO₂ emissions (grams)

💶 Price (EUR)

🔄 Layovers (direct or stops)

✨ Features (Wi‑Fi, in‑seat power, video, media streaming, etc.)

Contributing

I'll work with this project more in future, as I have plans for it. So contributions are always welcome!

Roadmap

  • Additional bug checking

  • Add more possibilities, as finding the shortest and economic path

💡Idea

It all started with a simple thought: “When is the best time to purchase a flight ticket?” and I found this website:

https://www.airhint.com/about

It actually offers pretty decent information, even predictions on whether to wait or buy now. However, their training data was already outdated, resulting in false predictions. So, I decided to build my own version. What did I need?

A scraper!

Since Google doesn't provide a public API, we, simple people who don't want to pay - are creating our own scraper.

The idea is straightforward: build a scraper that returns all results based on your filters.

Initially, I tried Playwright. It worked (and remains in the project as an alternative). We need smth different, which is faster and stable.

Then I examined the Google Flights URL: https://www.google.com/travel/flights?tfs=GisSCjIwMjUtMDctMjUoATICQlQyAkZSagUSA01BRHIFEgNLVU5yBRIDVk5PQgEBSAGYAQI%3D

Notice the tfs parameter:tfs=GisSCjIwMjUtMDctMjUoATICQlQyAkZSagUSA01BRHIFEgNLVU5yBRIDVk5PQgEBSAGYAQI%3D, which looks like base64. We need to decode it! How?

But raw decoding yields too much noise. Which protocol does Google use? - Correctly Protobuf! And what we can see here: Screenshot 2025-04-28 001211

That's our data! Half of the object is done. Next we need to parse, and get results.

Using data embedded in the response's script tag (<script class="ds:1">), I'm able to get much more data than what is parsed from the HTML. There are a few challenges: some fields require hardcoding. For example, features (in-seat power, etc.) are coded as: [null, null, null, null, null, null, null, null, null, null, null, 3]

You can see the features array is [… , 3] with that 3 sitting in slot 11 (zero-based).

We know slot 11 maps to Wi-Fi, and the code 3 means “for a fee” (whereas 2 would be "for free", and null means “not available”). With the same logic every else, which you need to find by yourself.

However, this approach is much faster than Playwright and provides richer data than pure HTML scraping!

🚀 About Me

I'm a Python developer with a deep passion for Data Science and ML Engineering.

I’m constantly exploring new techniques and tools to enhance my skills and dive into solving real-world problems through data-driven insights. Whether it's building models or optimizing data pipelines or analyzing data

🔗 Links

linkedin

github

Metadata

Release files for google-flights 0.0.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for google-flights 0.0.7
File Size Uploaded Provenance Actions
google_flights-0.0.7.tar.gz 17.2 kB Without provenance Details for google_flights-0.0.7.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for google-flights 0.0.7
File Interpreter ABI Platform Actions
google_flights-0.0.7-py3-none-any.whl Python 3 none any Details for google_flights-0.0.7-py3-none-any.whl

Total release size: 37.5 kB

Release files / google_flights-0.0.7.tar.gz

Download URL google_flights-0.0.7.tar.gz
Size 17.2 kB
Tags Source
SHA-256 checksum
How to use checksums
beafe8b84e7af95652e26c613fb69cefaf5ef2b1223f22252ffed7ee86b4d97e
BLAKE2b-256 checksum
How to use checksums
6b6e5ea74f43ea40713cb8bbf280dfb7dd50a3a0acf59ace2032e2bf6682543a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.2

Release files / google_flights-0.0.7-py3-none-any.whl

Download URL google_flights-0.0.7-py3-none-any.whl
Size 20.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
591e9405236a5b9c62787ba6d4429b1cb40b9452a0061ef17d13f98461caff92
BLAKE2b-256 checksum
How to use checksums
95bd51d1f32a4c861c993a8e7a8f520fc67127b05ccfc2fa0652ccfb96e8949e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.2

Security for google-flights 0.0.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page