Aircraft API

The Aircraft API provides detailed technical specs on over 1,000 airplane models from propeller planes to jumbo jets.

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

  • manufacturer  optional

    Company that designed and built the aircraft.

  • model  optional

    Aircraft model name.

  • engine_type  optional

    Type of engine. Must be one of: piston, propjet, jet.

  • min_speed  optional

    Minimum max. air speed in knots.

  • max_speed  optional

    Maximum max. air speed in knots.

  • min_range  optional

    Minimum range of the aircraft in nautical miles.

  • max_range  optional

    Maximum range of the aircraft in nautical miles.

  • min_length  optional

    Minimum length of the aircraft in feet.

  • max_length  optional

    Maximum length of the aircraft in feet.

  • min_height  optional

    Minimum height of the aircraft in feet.

  • max_height  optional

    Maximum height of the aircraft in feet.

  • min_wingspan  optional

    Minimum wingspan of the aircraft in feet.

  • max_wingspan  optional

    Maximum wingspan of the aircraft in feet.

  • limit  optional

    How many results to return. Must be between 1 and 30. Default is 1.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Sample Request Live Demo!

manufacturer
model
https://api.api-ninjas.com/v1/aircraft?manufacturer=Gulfstream&model=G550

Sample Response

JSON
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 [ { "manufacturer": "Gulfstream Aerospace", "model": "G550", "engine_type": "Jet", "engine_thrust_lb_ft": "15385", "max_speed_knots": "590", "cruise_speed_knots": "566", "ceiling_ft": "51000", "takeoff_ground_run_ft": "5910", "landing_ground_roll_ft": "2770", "gross_weight_lbs": "91000", "empty_weight_lbs": "47900", "length_ft": "96.417", "height_ft": "25.833", "wing_span_ft": "93.5", "range_nautical_miles": "6750" } ]

Code Examples

1 2 3 4 5 6 7 8 9 10 11 import requests manufacturer = 'Gulfstream' model = 'G550' api_url = 'https://api.api-ninjas.com/v1/aircraft?manufacturer={}&model={}'.format(manufacturer, model) response = requests.get(api_url, headers={'X-Api-Key': 'YOUR_API_KEY'}) if response.status_code == requests.codes.ok: print(response.text) else: print("Error:", response.status_code, response.text)

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.