Developer Documentation
Comprehensive airport database with 71,000+ airports, 36,000+ flight routes, 6,100+ airlines, 249 countries, 43,000+ runways, 255 aviation glossary terms, 14 interactive tools, and distance/flight-time calculations worldwide.
- 71,631 airports worldwide (large, medium, small, heliport, seaplane base) from OurAirports
- 36,428 pre-computed route pairs with distance (km), flight time, timezone difference
- 6,161 airlines with IATA/ICAO codes, routes, and country associations
- 249 countries with ISO 3166-1 alpha-2 codes and airport counts
- 43,651 runways with length, width, surface type, and lighting info
- 255 aviation glossary terms across categories (navigation, weather, operations, safety)
- 14 interactive tools: flight time calculator, distance calculator, flight time estimator, jet lag calculator, carbon calculator, timezone converter, runway comparator, and more
- Airport comparisons (N-squared): side-by-side stats for any two airports
- Air corridors: major flight corridors and route analysis
- Aviation hubs: hub airport profiles with connectivity data
- Rankings: busiest airports, longest runways, highest elevation
- City profiles: airports serving major cities worldwide
- Timezone listings: airports grouped by timezone
Quick Start
curl -s "https://airportfyi.com/api/v1/stats/"
API Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/v1/airports/ | List airports (paginated, filterable) |
| GET | /api/v1/airports/{id}/ | Airport detail |
| GET | /api/v1/airlines/ | List airlines (paginated) |
| GET | /api/v1/airlines/{id}/ | Airline detail |
| GET | /api/v1/countries/ | List countries |
| GET | /api/v1/countries/{id}/ | Country detail |
| GET | /api/v1/regions/ | List regions/states |
| GET | /api/v1/runways/ | List runways |
| GET | /api/v1/route-pairs/ | List route pairs with distance/time |
| GET | /api/v1/route-pairs/{id}/ | Route pair detail |
| GET | /api/v1/glossary-terms/ | List glossary terms |
| GET | /api/v1/glossary-categories/ | List glossary categories |
| GET | /api/v1/faqs/ | List FAQs |
| GET | /api/v1/search/?q={query} | Search airports, airlines, countries |
| GET | /api/v1/stats/ | Site-wide statistics |
| GET | /api/openapi.json | OpenAPI 3.0 schema |
| GET | /api/v1/docs/ | Interactive Swagger UI |
| GET | /api/search/ | Airport autocomplete search |
URL Patterns
Use these patterns to construct URLs programmatically:
/airport/{code}/
Airport detail by IATA or ICAO code (e.g. /airport/icn/)
/flights/{from}-to-{to}/
Flight route between two airports (e.g. /flights/icn-to-nrt/)
/distance/{from}-to-{to}/
Distance between two airports (e.g. /distance/jfk-to-lhr/)
/compare/{code1}-vs-{code2}/
Compare two airports side-by-side (e.g. /compare/jfk-vs-lax/)
/country/{code}/
All airports in a country (ISO alpha-2) (e.g. /country/kr/)
/airline/{slug}/
Airline detail with routes (e.g. /airline/korean-air/)
/continent/{slug}/
Airports by continent (e.g. /continent/asia/)
/busiest/
World's busiest airports ranking (e.g. /busiest/)
/rankings/
Airport rankings index (e.g. /rankings/)
/rankings/{slug}/
Specific ranking category (e.g. /rankings/longest-runways/)
/corridors/
Major air corridors (e.g. /corridors/)
/corridors/{slug}/
Corridor detail (e.g. /corridors/north-atlantic/)
/hubs/
Aviation hub airports (e.g. /hubs/)
/hubs/{slug}/
Hub airport detail (e.g. /hubs/atlanta/)
/cities/
Cities with airports (e.g. /cities/)
/cities/{slug}/
City airport profile (e.g. /cities/tokyo/)
/timezones/
Airports by timezone (e.g. /timezones/)
/timezones/{slug}/
Timezone detail (e.g. /timezones/america-new-york/)
/tools/
Interactive aviation tools index (e.g. /tools/)
/tools/{slug}/
Tool page (e.g. /tools/distance-calculator/)
/glossary/
Aviation glossary index (255 terms) (e.g. /glossary/)
/glossary/{slug}/
Glossary term detail (e.g. /glossary/iata-code/)
/guides/
Aviation guides (e.g. /guides/)
/guides/{series}/
Guide series (e.g. /guides/airport-codes/)
/guides/{series}/{slug}/
Individual guide (e.g. /guides/airport-codes/iata-vs-icao/)
/facts/
Aviation facts (e.g. /facts/)
/facts/{slug}/
Fact detail (e.g. /facts/busiest-airports-in-the-world/)
/blog/
Aviation blog (e.g. /blog/)
/blog/{slug}/
Blog article (e.g. /blog/understanding-iata-codes/)
/search/
Search airports, airlines, countries (e.g. /search/?q=incheon)
/nearby/
Airports near me hub (e.g. /nearby/)
/nearby/{airport-slug}/
Airports near a specific airport (e.g. /nearby/incheon-international-airport/)
Response Format
All endpoints return JSON with pagination:
Example JSON response
{
"count": 636,
"next": "https://example.com/api/v1/items/?page=2",
"previous": null,
"results": [
{"slug": "example", "name": "Example Item", "...": "..."}
]
}
OpenAPI Specification
Full API schema available as OpenAPI 3.1.0 JSON. Import into Swagger UI, Postman, or any OpenAPI-compatible tool.
SDK Packages
PyPI
pip install airportfyi
Airport data, IATA/ICAO lookup, distance calculation (v0.1.1)
npm
npm install airportfyi
TypeScript airport utilities (v0.1.0)
Format Support
- Markdown endpoints: Append
.mdto any page URL for LLM-friendly markdown output. - Internationalization: Content available in 14 languages: ko, ja, zh-hans, es, fr, de, pt, ru, vi, tr, ar, hi, th, id.