Search flights with a maximum number of stops (0=direct, 1=one stop, 2=two stops).
Args:
origin: Origin airport code (e.g., "SFO").
destination: Destination airport code (e.g., "JFK").
date: Departure date (YYYY-MM-DD format).
max_stops: Maximum number of stops (0, 1, or 2).
is_round_trip: If True, search round-trip flights (default: False).
return_date: Return date for round-trips (YYYY-MM-DD format).
adults: Number of adult passengers (default: 1).
seat_type: Fare class (default: "economy").
return_cheapest_only: If True, returns only the cheapest flight (default: False).
Example Args:
{"origin": "SFO", "destination": "JFK", "date": "2025-07-20", "max_stops": 1}
{"origin": "SFO", "destination": "JFK", "date": "2025-07-20", "max_stops": 0, "is_round_trip": true, "return_date": "2025-07-27"}