Kayak APIkayak.com ↗

"""Walkthrough: Kayak Flight Data SDK — bounded, re-runnable; every call capped."""
from parse_apis.kayak_flight_data_api import Kayak, TripType, PriceLevel, RouteNotFound

client = Kayak()

# Get a price calendar for a route — full ~300-day forecast in one call.
calendar = client.pricecalendars.get(origin="WAS", destination="LAX", trip_type=TripType.ROUND_TRIP)
print(f"Route: {calendar.origin} → {calendar.destination}, {calendar.total_dates} days forecasted")

# Inspect the cheapest predictions (green = cheap).
green_days = [p for p in calendar.predictions if p.price_level == PriceLevel.GREEN]
if green_days:
    cheapest = min(green_days, key=lambda p: p.avg_price)
    print(f"Cheapest green day: {cheapest.date} at ${cheapest.avg_price:.2f}")

# Construct an airport and list nearby alternatives.
lax = client.airport(code="LAX")
for apt in lax.nearby(limit=3):
    print(f"Nearby: {apt.display_name} — {apt.distance_miles} mi, popularity {apt.popularity}")

# List popular destinations from an origin airport.
jfk = client.airport(code="JFK")
for dest in jfk.destinations(limit=3):
    print(f"Destination: {dest.city} ({dest.airport_code}), {dest.country}")

# Typed error handling for an invalid route.
try:
    client.pricecalendars.get(origin="ZZZ", destination="QQQ")
except RouteNotFound as exc:
    print(f"Route not found: {exc}")

print("exercised: pricecalendars.get / airport.nearby / airport.destinations / RouteNotFound")