united.com APIunited.com ↗
Search United Airlines flights, check real-time flight status, retrieve seat maps, and compare fare options via 5 structured API endpoints.
curl -X POST 'https://api.parse.bot/scraper/5572e8f3-c457-4d99-86e9-b81c39820c26/search_flights' \
-H 'X-API-Key: $PARSE_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"origin": "EWR",
"destination": "SFO",
"departure_date": "2026-05-15"
}'Search for available United Airlines flights between two airports. Returns SSE-streamed chunks including metadata (cartId), fare family columns, and detailed flight options with prices and booking hashes.
| Param | Type | Description |
|---|---|---|
| originrequired | string | Origin airport IATA code (e.g. EWR, LAX, ORD) |
| trip_type | integer | 1 for one-way, 2 for roundtrip |
| num_adults | integer | Number of adult passengers |
| cabin_class | string | Cabin class preference: economy, business, first |
| destinationrequired | string | Destination airport IATA code (e.g. SFO, JFK, ORD) |
| return_date | string | Return date in YYYY-MM-DD format, required when trip_type is 2 |
| departure_daterequired | string | Departure date in YYYY-MM-DD format |
| flexible_dates | boolean | Search for refundable fares only |
| book_with_miles | boolean | Search for award travel with miles |
{
"type": "object",
"fields": {
"chunks": "array of SSE data chunks including meta (with cartId), columns, farefamilies, airports, equipments, cabinCodes, and flightOption objects with prices, products, and hash identifiers"
},
"sample": {
"data": {
"chunks": [
{
"type": "meta",
"cartId": "D6FD4DAE-8A7A-4340-8901-C03D1D08B0E1",
"origin": "EWR",
"status": "success",
"departDate": "2026-05-15",
"destination": "SFO"
},
{
"seq": "n1",
"type": "flightOption",
"flight": {
"hash": "135-2115-UA",
"origin": "EWR",
"products": [
{
"prices": [
{
"amount": 434,
"currency": "USD",
"pricingType": "Fare"
}
],
"productType": "ECONOMY"
}
],
"destination": "SFO",
"flightNumber": "2115",
"departDateTime": "2026-05-15 06:00",
"marketingCarrier": "UA",
"travelMinutesTotal": 390,
"destinationDateTime": "2026-05-15 09:30"
}
}
]
},
"status": "success"
}
}About the united.com API
The United Airlines API exposes 5 endpoints covering flight search, real-time status, seat maps, fare options, and airport autocomplete against united.com data. The search_flights endpoint streams back fare family columns, cabin codes, and per-flight booking hashes for one-way or roundtrip itineraries. get_seat_map returns row-level seat availability and cabin layout details. Together these endpoints cover the core booking research workflow without requiring a browser session.
Flight Search and Fare Data
search_flights accepts required origin and destination IATA codes plus a departure_date, and optionally trip_type (1 = one-way, 2 = roundtrip), num_adults, cabin_class (economy, business, or first), and return_date for roundtrips. Results arrive as SSE-streamed chunks containing a cartId in the meta chunk, fare family column definitions, flight options with prices, and a hash per flight option. That hash is required by get_fare_options to retrieve detailed fare quotes while the server-side cart session remains active.
Seat Maps and Flight Status
get_seat_map takes origin, destination, flight_number, and departure_date, with an optional departure_time in HH:mm format that should match the actual scheduled time — mismatches can return empty cabin data. The response includes a cabins array with cabinType, cabinBrand, layout, rowCount, availableSeats, totalSeats, and a rows array with per-seat detail, plus flightInfo and aircraftInfo (tail number and aircraft type code).
get_flight_status returns operational data for a given flight_number and date. The date window is limited to roughly ±2 days from the current date. The response includes flightLegs with OperationalFlightSegments covering departure and arrival times, gates, terminals, and equipment. This is useful for monitoring active flights but not for historical lookups.
Airport Autocomplete
search_airport_autocomplete accepts a free-text query (city name or IATA code) and returns an airports array. Each airport object includes IATACode, Name, IATACityCode, IATACountryCode, and StateProvince. This is the right starting point when an end user's input is a city name rather than a known airport code.
- Compare economy vs. business fare families across multiple United flights for a given city pair and date.
- Display a live departure board for United flights at a specific airport using get_flight_status.
- Render an interactive seat map showing available and occupied seats before booking a United flight.
- Build a fare-tracking tool that polls search_flights daily and records price changes via the fare family columns.
- Auto-suggest valid IATA codes in a trip-planning UI using search_airport_autocomplete city-name queries.
- Retrieve booking hashes and cart IDs from search_flights to feed into get_fare_options for full fare breakdowns.
- Monitor gate and terminal assignments for connecting flights using the flightLegs data in get_flight_status.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.