search_round_trips_in_date_range
Find available round-trip flights between specified airports within a flexible date range, with options to filter by stay duration and return only the cheapest options.
Instructions
Finds available round-trip flights within a specified date range.
Can optionally return only the cheapest flight found for each date pair.
⚠️ RATE LIMIT WARNING: This function makes multiple Google Flights scraping requests.
Each date pair combination = 1 request. The function is LIMITED to a MAXIMUM of 30
requests to prevent rate limiting and IP blocking.
Example request counts:
- 7 day range with 5-7 day stays: ~10-15 requests (Safe)
- 14 day range with no limits: ~105 requests (WILL BE REJECTED)
- 30 day range: ~465 requests (WILL BE REJECTED)
💡 TIP: Use min_stay_days and max_stay_days to reduce combinations.
Set return_cheapest_only=true for faster results.
Args:
origin: Origin airport code (e.g., "DEN").
destination: Destination airport code (e.g., "LAX").
start_date_str: Start date of the search range (YYYY-MM-DD format).
end_date_str: End date of the search range (YYYY-MM-DD format).
min_stay_days: Minimum number of days for the stay (optional).
max_stay_days: Maximum number of days for the stay (optional).
adults: Number of adult passengers (default: 1).
seat_type: Fare class (e.g., "economy", "business", default: "economy").
max_stops: Maximum number of stops (0=direct, 1=one stop, 2=two stops, default: 2).
return_cheapest_only: If True, returns only the cheapest flight for each date pair (default: False).
max_results: Maximum number of results to return (default: 10). Set to 0 or -1 for unlimited.
offset: Number of results to skip (for pagination, default: 0).
compact_mode: If True, return only essential fields (saves ~40% tokens, default: False).
limit: Maximum number of date pairs to process (for pagination, default: 20).
Example Args:
{"origin": "JFK", "destination": "MIA", "start_date_str": "2025-09-10", "end_date_str": "2025-09-20", "min_stay_days": 5}
{"origin": "JFK", "destination": "MIA", "start_date_str": "2025-09-10", "end_date_str": "2025-09-20", "min_stay_days": 5, "return_cheapest_only": true}Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| origin | Yes | ||
| destination | Yes | ||
| start_date_str | Yes | ||
| end_date_str | Yes | ||
| min_stay_days | No | ||
| max_stay_days | No | ||
| adults | No | ||
| seat_type | No | economy | |
| max_stops | No | ||
| return_cheapest_only | No | ||
| max_results | No | ||
| offset | No | ||
| limit | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |