search_round_trip_flights
Find round-trip flight options between specified airports for exact departure and return dates, with options to filter by price, stops, and passenger details.
Instructions
Fetches available round-trip flights for specific departure and return dates.
Can optionally return only the cheapest flight found.
💡 TIP: Default max_stops=2 provides more reliable scraping. For direct flights only,
use search_direct_flights() with is_round_trip=True instead.
Args:
origin: Origin airport code (e.g., "DEN").
destination: Destination airport code (e.g., "LAX").
departure_date: The specific departure date (YYYY-MM-DD format).
return_date: The specific return date (YYYY-MM-DD format).
adults: Number of adult passengers (default: 1).
children: Number of children (2-11 years, default: 0).
infants_in_seat: Number of infants in seat (under 2 years, default: 0).
infants_on_lap: Number of infants on lap (under 2 years, default: 0).
seat_type: Fare class - economy/premium_economy/business/first (default: "economy").
max_stops: Maximum number of stops (0=direct, 1=one stop, 2=two stops, default: 2).
Lower values = more reliable scraping. Set higher if needed, but may reduce reliability.
return_cheapest_only: If True, returns only the cheapest flight (default: False).
Example Args:
{"origin": "DEN", "destination": "LAX", "departure_date": "2025-08-01", "return_date": "2025-08-08"}
{"origin": "DEN", "destination": "LAX", "departure_date": "2025-08-01", "return_date": "2025-08-08", "adults": 2, "children": 2}
{"origin": "DEN", "destination": "LAX", "departure_date": "2025-08-01", "return_date": "2025-08-08", "max_stops": 0}Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| origin | Yes | ||
| destination | Yes | ||
| departure_date | Yes | ||
| return_date | Yes | ||
| adults | No | ||
| children | No | ||
| infants_in_seat | No | ||
| infants_on_lap | No | ||
| seat_type | No | economy | |
| max_stops | No | ||
| return_cheapest_only | No | ||
| max_results | No | ||
| compact_mode | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |