FlightConnections APIflightconnections.com ↗
Access FlightConnections data via API: search one-way flights with pricing, list non-stop routes from any airport, and fetch per-airline timetables.
What is the FlightConnections API?
The FlightConnections API covers 5 endpoints for querying flight routes, schedules, and pricing from FlightConnections.com. The search_flights endpoint returns one-way itineraries with up to one connection, including USD pricing, departure/arrival times in UTC, total duration in seconds, and layover detail. Other endpoints expose non-stop destination lists, per-route airline schedules with operating-day patterns, and full airport timetables paged by airline-route combination.
curl -X GET 'https://api.parse.bot/scraper/1f2490a2-e17c-4abc-b130-1e5d59bd7a66/search_flights?date=08%2F12%2F2026&origin=ARN&destination=IAH&max_layover_hours=5' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for one-way flights between two airports on a specific date. Returns flight options with up to one connection, filtered by maximum layover duration. Each result includes pricing in USD, airline codes, departure/arrival times (UTC), total duration in seconds, layover details (connecting airport and wait time), the marketing flight numbers of its segments (flight_numbers, e.g. IB427), a segments array with per-leg flight_number, marketing airline, operating carrier and operating flight number, origin/destination airports and UTC departure/arrival times, and a booking link. Paginates as a single page of up to 50 results after server-side filtering by stopovers and layover ceiling.
| Param | Type | Description |
|---|---|---|
| daterequired | string | Date of flight. Accepted formats: 14Nov2026, 2026-11-14, 14/11/2026. |
| originrequired | string | Origin airport IATA code (3-letter uppercase, e.g. ARN, IAD, IAH). |
| destinationrequired | string | Destination airport IATA code (3-letter uppercase, e.g. IAH, IAD, ARN). |
| max_layover_hours | number | Maximum layover duration in hours for flights with one connection. |
{
"type": "object",
"fields": {
"count": "integer total number of flights returned",
"params": "object echoing the search parameters used (origin, destination, date, max_layover_hours)",
"flights": "array of flight objects, each containing id, price, currency, departure_time, arrival_time, origin, destination, duration_total (seconds), layovers (array), airline, flight_numbers (array of marketing flight numbers, one per segment), segments (array of {flight_number, airline, operating_carrier, operating_flight_number, origin, destination, departure_time, arrival_time}), and booking_link"
},
"sample": {
"data": {
"count": 41,
"params": {
"date": "20/11/2026",
"origin": "MAD",
"destination": "BCN",
"max_layover_hours": 5
},
"flights": [
{
"id": "0a2213a25129000096816fad_0|13a201af51290000720b615f_0",
"price": 74,
"origin": "MAD",
"airline": "IB, VY",
"currency": "USD",
"layovers": [
{
"airport": "PMI",
"duration_hours": 4.75
}
],
"segments": [
{
"origin": "MAD",
"airline": "IB",
"destination": "PMI",
"arrival_time": "2026-11-20T17:10:00.000Z",
"flight_number": "IB1667",
"departure_time": "2026-11-20T15:45:00.000Z",
"operating_carrier": "I2",
"operating_flight_number": "I21667"
},
{
"origin": "PMI",
"airline": "VY",
"destination": "BCN",
"arrival_time": "2026-11-20T22:50:00.000Z",
"flight_number": "VY3941",
"departure_time": "2026-11-20T21:55:00.000Z",
"operating_carrier": "VY",
"operating_flight_number": "VY3941"
}
],
"destination": "BCN",
"arrival_time": "2026-11-20T22:50:00.000Z",
"booking_link": "https://www.kiwi.com/deep?affilid=flightconnectionsflightconnections¤cy=USD&flightsId=0a2213a25129000096816fad_0%7C13a201af51290000720b615f_0&from=MAD&lang=us&passengers=1&to=BCN&booking_token=<token>",
"departure_time": "2026-11-20T15:45:00.000Z",
"duration_total": 25500,
"flight_numbers": [
"IB1667",
"VY3941"
]
}
]
},
"status": "success"
}
}About the FlightConnections API
Flight Search and Pricing
The search_flights endpoint accepts an origin and destination IATA code pair, a date (formats: 14Nov2026, 2026-11-14, or 14/11/2026), and an optional max_layover_hours filter. Each flight object in the response includes price and currency, departure_time and arrival_time in UTC, duration_total in seconds, and layover detail for connecting itineraries. The count field and an echoed params block are also returned so callers can confirm the search parameters resolved correctly.
Route Network Coverage
list_airport_routes returns every non-stop destination served from a given origin airport — no date required. Each route object carries the destination IATA code, destination_name, country_code (ISO-2), country, duration_minutes, and both distance_miles and distance_km. Results are ordered by the site's own hub-priority ranking. list_airline_routes narrows this to a single carrier: supply an airline IATA code (e.g. IB for Iberia) alongside the origin and paginate with page and page_size (1–50). The response includes airline_name, total_routes, and a has_more flag.
Schedules and Timetables
get_route_schedule returns all airlines operating a specific non-stop route between origin and destination, with each carrier's operating_days (array of lowercase three-letter weekday names), duration_minutes, and weekly_schedule entries. The list_airport_schedule endpoint provides the full published schedule for an entire airport, selectable by direction (departures or arrivals). It paginates over airline-route combinations and includes an errors array and error_count for combinations where a timetable could not be fetched, so callers can handle partial results gracefully.
The FlightConnections API is a managed, monitored endpoint for flightconnections.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when flightconnections.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official flightconnections.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a flight-options comparison tool that surfaces one-way itineraries with USD pricing and layover times from
search_flights. - Map the complete non-stop route network of any airport using
list_airport_routesdestination IATA codes and distance fields. - Determine which days of the week a specific airline operates a given city pair via
get_route_scheduleoperating_days. - Audit an airline's entire departure footprint from a hub airport by paging through
list_airline_routeswith airline and origin. - Populate a live departures or arrivals board for an airport using
list_airport_schedulewith thedirectionparameter. - Identify thin routes (low airline count) on a corridor by comparing
get_route_schedulecount against busier pairs. - Feed route-network graphs with origin/destination pairs, distances, and durations from
list_airport_routes.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does FlightConnections have an official developer API?+
What does `search_flights` return, and how can I filter connections?+
search_flights returns one-way itineraries with up to one connection. Each flight object includes price (USD), departure_time and arrival_time in UTC, duration_total in seconds, and layover detail. To restrict results to shorter connections, pass max_layover_hours; flights whose layover exceeds that value are excluded from the response.Does `list_airport_schedule` return real-time gate or status information?+
list_airport_schedule returns the published scheduled timetable — operating days, departure times, and airline-route combinations — not live gate assignments, delays, or cancellations. For real-time flight status, you would need a separate live-ops data source. You can fork this API on Parse and revise it to add a live-status endpoint if a suitable source is available.Is round-trip or multi-city search supported?+
search_flights covers one-way itineraries only. Round-trip and multi-city search are not currently in the API. You can fork this API on Parse and revise it to add a round-trip endpoint by calling search_flights twice and combining the results.How does pagination work in `list_airline_routes` and `list_airport_schedule`?+
page and page_size (1–50) parameters. The has_more boolean in each response tells you whether additional pages exist. For list_airline_routes, total_routes gives the full destination count so you can calculate total pages upfront. list_airport_schedule also returns an error_count and errors array for any airline-route combinations that could not be fetched on a given page.