Flywizz

Flywizz SDK

An open-source unofficial API wrapper to get flight data from Wizz Air.

[!TIP]

MCP server for AI agents included. Plug Flywizz into Claude Desktop,

Claude Code, or Cursor and search Wizz Air flights in natural language.

Jump to the MCP Quickstart.

Contents

• Installation
• Quick Start
• Three things to know first
• API Reference
• Data Models
• Examples
• Checking many routes at once
• Flights that need a connection
• Explore Mode
• Use with Claude, Cursor, and other MCP clients
• API characteristics
• Caching
• Rate Limiting
• Contributing
• Disclaimer

Installation

pip install Flywizz

Or using uv:

uv add Flywizz

Quick Start

from datetime import datetime, timedelta

from flywizz import WizzAir, TimetableSearch

Initialize the client

client = WizzAir()

Set up search parameters

search = TimetableSearch( origin="BUD", # Budapest destination="LTN", # London Luton date_from=datetime.now() + timedelta(days=30), date_to=datetime.now() + timedelta(days=60), )

One call gets the schedule and the prices

for day in client.get_timetable(search): if day.price is None: continue print(f"{day.departure_date.date()}: {day.price.amount} {day.price.currency}") print(f" departures: {', '.join(d.departure.strftime('%H:%M') for d in day.departures)}")

Each entry is one operating day: the cheapest fare that day, plus every departure time, so a single call answers both "when does it fly" and "what does it cost".

Three things to know first

Prices are in the departure station's currency

Wizz Air has no server-side currency override. BUD -> LTN quotes in HUF, LTN -> BUD quotes in GBP, WAW -> LTN in PLN. Body fields, query params, cookies and headers named currency are all ignored.

Read Station.currency_code from get_network() if you need to know which currency you'll get before you search, and convert client-side.

Not every operating day carries a price

timetableV2 and farechart attach a price object to every day, but on days they will not quote inline, the amount is 0 and price_type is either checkPrice (a fare exists, but only through search/search) or noData. Flywizz maps both to price=None, so an unpriced day is never mistaken for a free one. Timetable entries still expose the indicative fare through original_price:

for day in client.get_timetable(search):

if day.price is not None: print(day.departure_date.date(), day.price.amount, day.price.currency) elif day.original_price is not None: print(day.departure_date.date(), "~", day.original_price.amount, "(check price)")

Search windows are capped, and the caps differ

Priced and unpriced surfaces disagree about how far ahead you may look. Both reject a wider window with 400 InvalidTimeDateRange and no further explanation, so Flywizz enforces each limit itself, in a message that names it.

from flywizz.misc import (

MAX_TIMETABLE_WINDOW_DAYS, # 42, for timetableV2 and farechart MAX_FLIGHT_DATES_WINDOW_DAYS, # 62, for the schedule endpoints )

cheapest_weekend() splits the range internally, since its default of months_ahead=3 far exceeds either cap.

search/search is behind a bot gate

Four endpoints (search/search, booking/seatmap, booking/ancillaries, booking/passengers) sit behind Kasada and answer 429 with an empty body from any non-browser client. Flywizz raises BotGateError rather than trying to solve the challenge.

Everything else, including the priced timetableV2 and farechart surfaces, is open. That is enough for price tracking, route exploration and calendar search. If you need fare bundles and sell keys, drive a real browser session and pass its headers in:

from flywizz import WizzAir, WizzairTransport

client = WizzAir(WizzairTransport(kasada_headers={ "x-kpsdk-ct": "...", "x-kpsdk-v": "...", "x-kpsdk-h": "...", "x-kpsdk-cd": "...", }))

Full details of the gate, the session handshake, and the whole route table are in docs/internal-api-spec.md.

API Reference

WizzAir Class

Constructor

WizzAir(transport: Optional[Transport] = None)

Creates a new Wizz Air client instance.

Parameters:

• transport (Transport, optional): Inject a custom transport, e.g. a CachingTransport wrapping the default, a WizzairTransport with kasada_headers, or a fixture transport for tests. Defaults to a fresh WizzairTransport.

Example:

# Defaults

client = WizzAir()

With caching for the 650 KB network metadata

from flywizz import CachingTransport, WizzairTransport client = WizzAir(CachingTransport(WizzairTransport(), ttl=3600))

Methods

Every method exists on AsyncWizzAir with the same signature.

TimetableSearch Class

Parameters for a timetable search.

TimetableSearch(

origin: str, destination: str, date_from: datetime, date_to: datetime, return_date_from: Optional[datetime] = None, return_date_to: Optional[datetime] = None, adults: int = 1, children: int = 0, infants: int = 0, price_type: str = "regular", )

Parameters:

• origin (str): IATA code of the departure station (e.g. "BUD")
• destination (str): IATA code of the arrival station (e.g. "LTN")
• date_from (datetime): Start of the outbound departure window
• date_to (datetime): End of the outbound departure window
• return_date_from / return_date_to (datetime, optional): Inbound window. Both are required by get_return_timetable()
• adults / children / infants (int): Passenger counts. At least one adult
• price_type (str): "regular" or "wdc" for Wizz Discount Club pricing

FareChartSearch Class

Parameters for the price strip.

FareChartSearch(

origin: str, destination: str, date: datetime, day_interval: int = 3, adults: int = 1, children: int = 0, infants: int = 0, price_type: str = "regular", )

day_interval is the half-window around date and must be at least 3, so the default returns seven days. Smaller values are rejected upstream with DayIntervalMustBeGreaterOrEqualTo3.

AvailabilitySearch Class

Parameters for the bot-gated availability call.

AvailabilitySearch(

origin: str, destination: str, departure_date: datetime, return_date: Optional[datetime] = None, wdc: bool = True, is_flight_change: bool = False, adults: int = 1, children: int = 0, infants: int = 0, )

Data Models

Price

Represents a money amount as Wizz Air reports it.

Attributes:

• amount (float): The amount
• currency (str): ISO 4217 code, always the departure station's currency
• exchanged_amount (Optional[float]): The SPA's client-side conversion hook. Stays None for anonymous sessions
• exchanged_currency (Optional[str]): Currency of exchanged_amount

TimetableEntry

One operating day for a route, with its cheapest fare.

Attributes:

• departure_station (str), arrival_station (str): IATA codes
• departure_date (datetime): The operating day
• price (Optional[Price]): Cheapest fare that day, None if sold out
• original_price (Optional[Price]): Pre-discount price
• departures (list[Departure]): Every departure that day
• price_type (Optional[str]): "price" when there was inventory
• has_mac_flight (bool): The route includes a metropolitan-area alternative
• applied_coupon_code (Optional[str])

Departure

Attributes:

• departure (datetime): Departure time
• is_cheapest_of_the_day (bool): This is the departure price refers to

FlightDate

One operating day from get_connecting_flight_dates().

Attributes:

• date (datetime): The operating day
• stops (int): 0 for a direct flight, 1 or more for a connection
• is_direct (bool): Property, true when stops is 0

FareChartEntry

One day of the price strip.

Attributes:

• departure_station (str), arrival_station (str): IATA codes
• day (datetime): The day
• price (Optional[Price]): Cheapest price that day
• class_of_service (Optional[str]): Booking class the quote came from
• price_type (Optional[str]), has_mac_flight (bool)

Station

An airport in Wizz Air's live network. Returned by the explore methods.

Attributes:

• iata (str): IATA station code
• name (str): Station name
• country_code (str): Uppercase ISO2 country code (e.g. "HU", "GB")
• country_name (str): Country name
• currency_code (str): Local cu