Developer Documentation

Comprehensive aircraft encyclopedia for aviation enthusiasts, pilots, and industry professionals. Covers aircraft types by manufacturer and family, engine profiles, aircraft systems, seat maps, fleet data by airline, interactive tools, aviation glossary, and in-depth guides. 15 languages supported.

Quick Start

curl -s "https://planefyi.com/api/v1/aircraft-types/"

API Endpoints

Method Endpoint Description
GET /api/v1/manufacturers/ List aircraft manufacturers
GET /api/v1/aircraft-families/ Aircraft families
GET /api/v1/aircraft-types/ All aircraft types with specs
GET /api/v1/aircraft-types/{slug}/ Aircraft type detail
GET /api/v1/airlines/ Airlines with fleet data
GET /api/v1/fleet/ Fleet records
GET /api/v1/engine-profiles/ Engine profiles
GET /api/v1/aircraft-systems/ Aircraft systems
GET /api/v1/seat-maps/ Seat maps
GET /api/v1/aviation-terms/ Aviation glossary terms
GET /api/v1/faqs/ FAQs
GET /api/v1/stats/ Site statistics
GET /api/v1/search/?q={query} Search across all content

URL Patterns

Use these patterns to construct URLs programmatically:

/aircraft/ Browse all aircraft types (e.g. /aircraft/)
/aircraft/{slug}/ Aircraft type detail with specs (e.g. /aircraft/boeing-737-800/)
/manufacturers/ Aircraft manufacturers (e.g. /manufacturers/)
/manufacturer/{slug}/ Manufacturer detail (e.g. /manufacturer/boeing/)
/family/{slug}/ Aircraft family detail (e.g. /family/airbus-a320/)
/engines/ Engine profiles (e.g. /engines/)
/engines/{slug}/ Engine detail (e.g. /engines/cfm56-5b/)
/systems/ Aircraft systems (e.g. /systems/)
/systems/{slug}/ System detail (e.g. /systems/fly-by-wire/)
/seatmaps/{airline}/{aircraft}/ Seat map detail (e.g. /seatmaps/korean-air/boeing-777-300er/)
/airlines/ Airlines with fleet data (e.g. /airlines/)
/airline/{slug}/ Airline fleet detail (e.g. /airline/korean-air/)
/compare/ Aircraft comparisons (e.g. /compare/)
/compare/{slug1}-vs-{slug2}/ Side-by-side comparison (e.g. /compare/boeing-737-800-vs-airbus-a320neo/)
/tools/ Interactive tools (e.g. /tools/)
/tools/seat-comparison/ Seat comparison tool (e.g. /tools/seat-comparison/)
/tools/range-map/ Aircraft range map (e.g. /tools/range-map/)
/tools/fleet-age/ Fleet age analyzer (e.g. /tools/fleet-age/)
/glossary/ Aviation glossary (e.g. /glossary/)
/glossary/{slug}/ Glossary term detail (e.g. /glossary/mtow/)
/guides/ In-depth guides (e.g. /guides/)
/search/ Search aircraft, engines, glossary (e.g. /search/?q=boeing)

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 planefyi

Aircraft models and specifications API client

Embed Widget

Embed data cards on your site: https://widget.planefyi.com
npm install planefyi-embed

Format Support

  • Markdown endpoints: Append .md to 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.