Aircraft API
The Aircraft API provides detailed technical specs on over 1,000 airplane models from propeller planes to jumbo jets.
From 9,339 users
Applications using this API
API Status
API Response Times
Average | P50 | P75 | P90 | P95 |
|---|---|---|---|---|
| 290ms | 328ms | 351ms | 492ms | 970ms |
Similar APIs
Didn't find what you were looking for? Suggest an improvement
/v1/aircraft GET
https://api.api-ninjas.com/v1/aircraft
Returns a list of aircrafts that match the given parameters. This API only supports airplanes - for helicopter specs please use our Helicopter API.
Parameters
At least one of the following parameters (other than limit) must be set.
manufactureroptionalCompany that designed and built the aircraft.
modeloptionalAircraft model name.
engine_typeoptionalType of engine. Must be one of:
piston,propjet,jet.min_speedoptionalMinimum max. air speed in knots.
max_speedoptionalMaximum max. air speed in knots.
min_rangeoptionalMinimum range of the aircraft in nautical miles.
max_rangeoptionalMaximum range of the aircraft in nautical miles.
min_lengthoptionalMinimum length of the aircraft in feet.
max_lengthoptionalMaximum length of the aircraft in feet.
min_heightoptionalMinimum height of the aircraft in feet.
max_heightoptionalMaximum height of the aircraft in feet.
min_wingspanoptionalMinimum wingspan of the aircraft in feet.
max_wingspanoptionalMaximum wingspan of the aircraft in feet.
limitoptionalHow many results to return. Must be between
1and30. Default is1.
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Response
A JSON array of objects, each containing the following fields, or an error if the request is unsuccessful.
manufacturerCompany that designed and built the aircraft.
modelAircraft model name.
engine_typeType of engine (e.g., "Jet", "Piston", "Propjet").
engine_thrust_lb_ftEngine thrust in pounds-force.
max_speed_knotsMaximum air speed in knots.
cruise_speed_knotsCruise speed in knots.
ceiling_ftService ceiling in feet.
takeoff_ground_run_ftTakeoff ground run distance in feet.
landing_ground_roll_ftLanding ground roll distance in feet.
gross_weight_lbsGross weight in pounds.
empty_weight_lbsEmpty weight in pounds.
length_ftLength in feet.
height_ftHeight in feet.
wing_span_ftWingspan in feet.
range_nautical_milesRange in nautical miles.
Sample Request Live Demo!
Try this API endpoint with all available parameters in our API playground
https://api.api-ninjas.com/v1/aircraft?manufacturer=Gulfstream&model=G550Headers
X-Api-KeyLog in or sign up to get your API KeySample Response
Code Examples
1
2
curl -X GET "https://api.api-ninjas.com/v1/aircraft?manufacturer=Gulfstream&model=G550" \
-H "X-Api-Key: YOUR_API_KEY"If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.
Frequently Asked Questions
Can I use the Aircraft API for commercial purposes?
Yes, but you must have a premium subscription. Commercial use of the Aircraft API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.How do I get an API key and start using the Aircraft API?
Sign up for a free account to instantly get your API key, then pass it in theX-Api-Keyheader on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.What happens if I exceed my quota for the month?
Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.What happens if a request to the Aircraft API fails?
The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.How do I look up a specific aircraft model with the Aircraft API?
Pass themanufacturerand/ormodelquery parameters to the/v1/aircraftendpoint, for example manufacturer=Gulfstream and model=G550. At least one parameter (other thanlimit) must be set, and you can return up to 30 matches by adjusting thelimitparameter (default1). Get a free API key by registering for an account.What technical specs does the Aircraft API return for each airplane?
Each result includes performance and dimension fields such asengine_type,engine_thrust_lb_ft,max_speed_knots,cruise_speed_knots,ceiling_ft,range_nautical_miles,length_ft,height_ft,wing_span_ft, and weight fields likegross_weight_lbsandempty_weight_lbs. If a request is unsuccessful you receive an error instead, documented on our error codes page.Can I filter aircraft by performance characteristics instead of by name?
Yes, you can search by ranges using parameters likemin_speed,max_speed,min_range,max_range,min_length, andmax_wingspan, and you can restrict byengine_type(one ofpiston,propjet, orjet). Browse all API Ninjas APIs for related transportation data.Does the Aircraft API cover helicopters?
No, the Aircraft API only supports airplanes, covering over 1,000 models from propeller planes to jumbo jets; for rotorcraft specs use the Helicopter API instead. You can also explore the Airlines and Airports APIs for more aviation data.