redBus APIredbus.in ↗

"""Walkthrough: redBus API — search cities, buses, trains, get details and schedules."""
from parse_apis.redBus_Bus_and_Train_API import RedBus, NotFoundError

client = RedBus()

# Search cities to get IDs for bus search
for city in client.cities.search(query="Mumbai", limit=5):
    print(city.name, city.location_name, city.region)

# Search buses between two cities on a future date
bus = client.bus_services.search(
    from_city_id="462", to_city_id="130", doj="26-Jun-2026", limit=1
).first()
if bus:
    print(bus.travels_name, bus.bus_type, bus.available_seats, bus.fare_list)

    # Get detailed boarding/dropping points for this bus
    detail = bus.details(doj="26-Jun-2026", from_city_id="462", to_city_id="130")
    for bp in detail.boarding_points[:3]:
        print(bp.name, bp.time, bp.address)

    # Get seat layout for this bus
    layout = bus.seat_layout(doj="26-Jun-2026")
    for svc in layout.services[:1]:
        print(svc.bus_type, svc.available_seats)

# Search trains between stations
for result in client.train_results.search(src="MMCT", dst="NDLS", doj="20260625", limit=3):
    print(result.train_name, result.train_number, result.duration, result.distance)

# Construct a train by number and get its full schedule
try:
    sched = client.train(train_no="22209").schedule()
    print(sched.train_name, sched.source, sched.destination)
    for stop in sched.stops[:3]:
        print(stop.station_name, stop.station_code, stop.departure_time)
except NotFoundError as exc:
    print(f"Not found: {exc}")

# Search trains by name
train = client.trains.search(query="Rajdhani", limit=1).first()
if train:
    print(train.train_name, train.train_no, train.src_station_name)

print("exercised: cities.search / bus_services.search / bus.details / bus.seat_layout / train_results.search / train.schedule / trains.search")