# AirportFYI

> 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.

## Data Scope
- 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

## URL Patterns
- Append `.md` to any URL for plain-text markdown format.
- i18n: URL prefix `/{lang}` for non-English (ko, ja, zh-hans, es, fr, de, pt, ru, vi, tr, ar, hi, th, id).
- `/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/`)

## Browse Airports
- [All Airports](https://airportfyi.com/airports/)
- [Busiest Airports](https://airportfyi.com/busiest/)
- [By Country (249)](https://airportfyi.com/countries/)
- [By Continent](https://airportfyi.com/continents/)
- [By Timezone](https://airportfyi.com/timezones/)
- [By City](https://airportfyi.com/cities/)
- [Rankings](https://airportfyi.com/rankings/)

## Airlines
- [All Airlines (6,100+)](https://airportfyi.com/airlines/)

## Flight Routes & Distance
- [Route Lookup (e.g. ICN to NRT)](https://airportfyi.com/flights/icn-to-nrt/)
- [Distance Lookup (e.g. JFK to LHR)](https://airportfyi.com/distance/jfk-to-lhr/)
- [Airport Comparison](https://airportfyi.com/compare/)

## Air Corridors & Hubs
- [Air Corridors](https://airportfyi.com/corridors/)
- [Aviation Hubs](https://airportfyi.com/hubs/)

## Interactive Tools
- [Flight Time Calculator](https://airportfyi.com/tools/flight-time/)
- [Distance Calculator](https://airportfyi.com/tools/distance-calculator/)
- [Flight Time Estimator](https://airportfyi.com/tools/flight-time-calculator/)
- [Multi-City Trip Calculator](https://airportfyi.com/tools/multi-city-trip-calculator/)
- [Flight Duration Comparator](https://airportfyi.com/tools/flight-duration-comparator/)
- [Jet Lag Calculator](https://airportfyi.com/tools/jet-lag-calculator/)
- [Flight Carbon Calculator](https://airportfyi.com/tools/flight-carbon-calculator/)
- [Travel Health Timer](https://airportfyi.com/tools/travel-health-timer/)
- [Airport Timezone Converter](https://airportfyi.com/tools/airport-timezone-converter/)
- [Runway Comparator](https://airportfyi.com/tools/runway-comparator/)
- [Elevation Comparator](https://airportfyi.com/tools/elevation-comparator/)
- [Connection Time Calculator](https://airportfyi.com/tools/connection-time-calculator/)
- [Sunrise/Sunset Calculator](https://airportfyi.com/tools/sunrise-sunset-calculator/)
- [Layover Planner](https://airportfyi.com/tools/layover-planner/)

## Aviation Knowledge
- [Glossary (255 terms)](https://airportfyi.com/glossary/)
- [Guides](https://airportfyi.com/guides/)
- [Aviation Facts](https://airportfyi.com/facts/)
- [Blog](https://airportfyi.com/blog/)

## Feeds
- [Guides RSS](https://airportfyi.com/guides/feed/rss/)
- [Guides Atom](https://airportfyi.com/guides/feed/atom/)
- [Blog RSS](https://airportfyi.com/blog/feed/rss/)
- [Blog Atom](https://airportfyi.com/blog/feed/atom/)

## Nearby Airports
- [Airports Near Me](https://airportfyi.com/nearby/)

## Embed Widget
- [AirportFYI Widget Docs](https://widget.airportfyi.com)
- [airportfyi-embed on npm](https://www.npmjs.com/package/airportfyi-embed)
- [airportfyi-embed on GitHub](https://github.com/fyipedia/airportfyi-embed)

## REST API

Free REST API. No authentication required. JSON responses. CORS enabled.

| 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 |

```bash
curl -s "https://airportfyi.com/api/v1/stats/"
```

[OpenAPI Spec](https://airportfyi.com/api/openapi.json)

## Developer Tools
- **PyPI**: `pip install airportfyi` — [airportfyi](https://pypi.org/project/airportfyi/) — Airport data, IATA/ICAO lookup, distance calculation (v0.1.1)
- **npm**: `npm install airportfyi` — [airportfyi](https://www.npmjs.com/package/airportfyi) — TypeScript airport utilities (v0.1.0)

## Transport FYI Family

Part of [FYIPedia](https://fyipedia.com) developer tools ecosystem.
- [AirlineFYI](https://airlinefyi.com) — Airlines, fleets, alliances, routes
- [PlaneFYI](https://planefyi.com) — Aircraft models, specifications, manufacturers
- [TrainFYI](https://trainfyi.com) — Railway stations, train routes, rail networks

## Images (CDN)

OG images for airports and pages at https://cdn.airportfyi.com/og/{slug}.png
- https://cdn.airportfyi.com/og/homepage.png
- https://cdn.airportfyi.com/og/airports/icn.png

## Full Index
- [Full content index](https://airportfyi.com/llms-full.txt)
- [XML Sitemap](https://airportfyi.com/sitemap.xml)