NS International APInsinternational.nl ↗

"""Walkthrough: NS International — find stations, check fares, browse itineraries."""
from parse_apis.nsinternational_nl_api import NsInternational, InputNotFound

client = NsInternational()

# Find the station code for Paris (needed by every other endpoint).
station = client.stations.search(name="Paris", limit=5).first()
if station is None:
    raise SystemExit("no station matched")
print(station.name, station.station_code, station.country_code)

# Pull the price calendar for Amsterdam → Paris and pick a cheap bookable day.
calendar = client.price_calendars.get(origin="NLASC", destination=station.station_code)
print(f"{calendar.days_with_price} of {calendar.count} days have a price")

cheap_day = None
if calendar.days is not None:
    for day in calendar.days:
        if day.lowest_price is not None:
            cheap_day = day
            break  # first priced day is enough
if cheap_day is not None:
    print(cheap_day.date, f"€{cheap_day.lowest_price}", cheap_day.price_category)

# Search itineraries for that date, capped to the first few results.
if cheap_day is not None:
    try:
        for itin in client.itineraries.search(
            origin="NLASC",
            destination=station.station_code,
            travel_date=cheap_day.date,
            limit=3,
        ):
            print(
                itin.origin.name, "→", itin.destination.name,
                itin.duration, f"changes={itin.number_of_changes}",
                f"from €{itin.lowest_price}" if itin.lowest_price is not None else "sold out",
            )
            for offer in itin.offers:
                print(f"  {offer.name} class {offer.class_level} €{offer.total_price}")
    except InputNotFound:
        print("route not found for", cheap_day.date)

print("exercised: stations.search / price_calendars.get / itineraries.search")