Flight Search
Search Google Flights for real-time fares, compare dates, and find the cheapest travel options.
You have access to flight search through the OpenLabor API.
How to Search Flights
Use the exec tool to run use. Credentials are loaded automatically from the workspace.
use flights SEARCH_FLIGHTS '{"origin":"JFK","destination":"LAX","date":"2026-12-25"}'
Search Flights Parameters
| Parameter |
Type |
Default |
Description |
origin |
string |
required |
Departure airport IATA code (e.g. "JFK", "CDG", "NRT") |
destination |
string |
required |
Arrival airport IATA code (e.g. "LAX", "LHR", "SIN") |
date |
string |
required |
Travel date in YYYY-MM-DD format |
cabin_class |
string |
"ECONOMY" |
One of: "ECONOMY", "PREMIUM_ECONOMY", "BUSINESS", "FIRST" |
max_stops |
string |
"ANY" |
One of: "NON_STOP", "ONE_STOP", "TWO_PLUS", "ANY" |
sort_by |
string |
"CHEAPEST" |
One of: "CHEAPEST", "DURATION", "DEPARTURE_TIME", "ARRIVAL_TIME" |
airlines |
string |
"" |
Comma-separated IATA airline codes to filter (e.g. "AA,UA,DL") |
departure_time |
string |
"" |
Time window in HH-HH format (e.g. "06-20" for 6am-8pm) |
adults |
string |
"1" |
Number of adult passengers |
Example Flight Searches
# Basic one-way search
use flights SEARCH_FLIGHTS '{"origin":"JFK","destination":"LAX","date":"2026-12-25"}'
# Business class, non-stop only
use flights SEARCH_FLIGHTS '{"origin":"JFK","destination":"LHR","date":"2026-10-25","cabin_class":"BUSINESS","max_stops":"NON_STOP"}'
# Morning departures, sorted by duration
use flights SEARCH_FLIGHTS '{"origin":"CDG","destination":"NRT","date":"2026-06-15","departure_time":"06-12","sort_by":"DURATION"}'
# Specific airlines only
use flights SEARCH_FLIGHTS '{"origin":"SFO","destination":"SEA","date":"2026-08-01","airlines":"UA,AS","max_stops":"NON_STOP"}'
How to Search Dates
Find the cheapest fares across a date range.
use flights SEARCH_DATES '{"origin":"JFK","destination":"LHR","from_date":"2026-01-01","to_date":"2026-02-01"}'
Search Dates Parameters
| Parameter |
Type |
Default |
Description |
origin |
string |
required |
Departure airport IATA code |
destination |
string |
required |
Arrival airport IATA code |
from_date |
string |
required |
Start of date range (YYYY-MM-DD) |
to_date |
string |
required |
End of date range (YYYY-MM-DD) |
days_of_week |
string |
"" |
Filter by day names, comma-separated (e.g. "monday,friday") |
cabin_class |
string |
"ECONOMY" |
One of: "ECONOMY", "PREMIUM_ECONOMY", "BUSINESS", "FIRST" |
Example Date Searches
# Find cheapest dates in January
use flights SEARCH_DATES '{"origin":"JFK","destination":"LHR","from_date":"2026-01-01","to_date":"2026-01-31"}'
# Weekend flights only
use flights SEARCH_DATES '{"origin":"LAX","destination":"CUN","from_date":"2026-03-01","to_date":"2026-04-01","days_of_week":"friday,saturday"}'
# Business class date comparison
use flights SEARCH_DATES '{"origin":"SFO","destination":"NRT","from_date":"2026-06-01","to_date":"2026-06-30","cabin_class":"BUSINESS"}'
Response Format
Flight search returns an array of flights, each with:
price — Fare in local currencyduration — Total flight timeairline — Operating carrier(s)stops — Number of stops and layover infodeparture_time — Departure date and timearrival_time — Arrival date and time
Date search returns an array of dates with:
date — Travel dateprice — Cheapest fare for that date
Research Workflows
Budget Travel Planning
- Search dates for a broad range to find cheapest window
- Search flights on the cheapest dates for detailed options
- Compare across cabin classes if budget allows upgrades
Business Trip Logistics
- Search flights with
cabin_class: "BUSINESS" and max_stops: "NON_STOP"
- Filter by departure time window for schedule compatibility
- Present top 3 options with price/duration tradeoffs
Date Flexibility Analysis
- Use SEARCH_DATES across a full month
- Filter by preferred days of week
- Identify price patterns (mid-week vs weekend, early vs late month)
- Recommend optimal travel dates with savings estimate
Multi-City Comparison
- Search same dates across multiple origin or destination airports
- Compare fares (e.g. JFK vs EWR vs LGA for NYC departures)
- Factor in ground transport time/cost for true comparison
Guidelines
- Always present prices with currency
- Results are real-time from Google Flights — prices change frequently
- Use SEARCH_DATES first when the traveler has flexible dates, then SEARCH_FLIGHTS for details
- Airport codes must be valid IATA codes (3 letters)
- For round trips, search each leg separately
- Rate limits apply — avoid rapid repeated searches
- Note: this uses reverse-engineered Google Flights data, not an official API
1---2name: flight-search3description: Search Google Flights for cheapest fares, compare dates, filter by cabin class, stops, airlines, and departure times — powered by fli4---56<!-- openlabor-connector: flights, api_key={{INTERNAL_API_KEY}}, employee={{EMPLOYEE_ID}}, base={{API_BASE_URL}} -->78# Flight Search910Search Google Flights for real-time fares, compare dates, and find the cheapest travel options.1112You have access to flight search through the OpenLabor API.1314## How to Search Flights1516Use the exec tool to run `use`. Credentials are loaded automatically from the workspace.1718```19use flights SEARCH_FLIGHTS '{"origin":"JFK","destination":"LAX","date":"2026-12-25"}'20```2122### Search Flights Parameters2324| Parameter | Type | Default | Description |25|-----------|------|---------|-------------|26| `origin` | string | required | Departure airport IATA code (e.g. "JFK", "CDG", "NRT") |27| `destination` | string | required | Arrival airport IATA code (e.g. "LAX", "LHR", "SIN") |28| `date` | string | required | Travel date in YYYY-MM-DD format |29| `cabin_class` | string | "ECONOMY" | One of: "ECONOMY", "PREMIUM_ECONOMY", "BUSINESS", "FIRST" |30| `max_stops` | string | "ANY" | One of: "NON_STOP", "ONE_STOP", "TWO_PLUS", "ANY" |31| `sort_by` | string | "CHEAPEST" | One of: "CHEAPEST", "DURATION", "DEPARTURE_TIME", "ARRIVAL_TIME" |32| `airlines` | string | "" | Comma-separated IATA airline codes to filter (e.g. "AA,UA,DL") |33| `departure_time` | string | "" | Time window in HH-HH format (e.g. "06-20" for 6am-8pm) |34| `adults` | string | "1" | Number of adult passengers |3536### Example Flight Searches3738```39# Basic one-way search40use flights SEARCH_FLIGHTS '{"origin":"JFK","destination":"LAX","date":"2026-12-25"}'4142# Business class, non-stop only43use flights SEARCH_FLIGHTS '{"origin":"JFK","destination":"LHR","date":"2026-10-25","cabin_class":"BUSINESS","max_stops":"NON_STOP"}'4445# Morning departures, sorted by duration46use flights SEARCH_FLIGHTS '{"origin":"CDG","destination":"NRT","date":"2026-06-15","departure_time":"06-12","sort_by":"DURATION"}'4748# Specific airlines only49use flights SEARCH_FLIGHTS '{"origin":"SFO","destination":"SEA","date":"2026-08-01","airlines":"UA,AS","max_stops":"NON_STOP"}'50```5152## How to Search Dates5354Find the cheapest fares across a date range.5556```57use flights SEARCH_DATES '{"origin":"JFK","destination":"LHR","from_date":"2026-01-01","to_date":"2026-02-01"}'58```5960### Search Dates Parameters6162| Parameter | Type | Default | Description |63|-----------|------|---------|-------------|64| `origin` | string | required | Departure airport IATA code |65| `destination` | string | required | Arrival airport IATA code |66| `from_date` | string | required | Start of date range (YYYY-MM-DD) |67| `to_date` | string | required | End of date range (YYYY-MM-DD) |68| `days_of_week` | string | "" | Filter by day names, comma-separated (e.g. "monday,friday") |69| `cabin_class` | string | "ECONOMY" | One of: "ECONOMY", "PREMIUM_ECONOMY", "BUSINESS", "FIRST" |7071### Example Date Searches7273```74# Find cheapest dates in January75use flights SEARCH_DATES '{"origin":"JFK","destination":"LHR","from_date":"2026-01-01","to_date":"2026-01-31"}'7677# Weekend flights only78use flights SEARCH_DATES '{"origin":"LAX","destination":"CUN","from_date":"2026-03-01","to_date":"2026-04-01","days_of_week":"friday,saturday"}'7980# Business class date comparison81use flights SEARCH_DATES '{"origin":"SFO","destination":"NRT","from_date":"2026-06-01","to_date":"2026-06-30","cabin_class":"BUSINESS"}'82```8384### Response Format8586Flight search returns an array of flights, each with:87- `price` — Fare in local currency88- `duration` — Total flight time89- `airline` — Operating carrier(s)90- `stops` — Number of stops and layover info91- `departure_time` — Departure date and time92- `arrival_time` — Arrival date and time9394Date search returns an array of dates with:95- `date` — Travel date96- `price` — Cheapest fare for that date9798## Research Workflows99100### Budget Travel Planning1011. Search dates for a broad range to find cheapest window1022. Search flights on the cheapest dates for detailed options1033. Compare across cabin classes if budget allows upgrades104105### Business Trip Logistics1061. Search flights with `cabin_class: "BUSINESS"` and `max_stops: "NON_STOP"`1072. Filter by departure time window for schedule compatibility1083. Present top 3 options with price/duration tradeoffs109110### Date Flexibility Analysis1111. Use SEARCH_DATES across a full month1122. Filter by preferred days of week1133. Identify price patterns (mid-week vs weekend, early vs late month)1144. Recommend optimal travel dates with savings estimate115116### Multi-City Comparison1171. Search same dates across multiple origin or destination airports1182. Compare fares (e.g. JFK vs EWR vs LGA for NYC departures)1193. Factor in ground transport time/cost for true comparison120121## Guidelines122- Always present prices with currency123- Results are real-time from Google Flights — prices change frequently124- Use SEARCH_DATES first when the traveler has flexible dates, then SEARCH_FLIGHTS for details125- Airport codes must be valid IATA codes (3 letters)126- For round trips, search each leg separately127- Rate limits apply — avoid rapid repeated searches128- Note: this uses reverse-engineered Google Flights data, not an official API
OpenLabor