Aircraft API

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

/v1/aircraft

HTTP GET

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 (excluding the limit parameter) must be set.

manufacturer - company that designed and built the aircraft.

model - aircraft model name.

engine_type - type of engine. Must be one of: piston, propjet, jet.

min_speed - minimum max. air speed in knots.

max_speed - maximum max. air speed in knots.

min_range - minimum range of the aircraft in nautical miles.

max_range - maximum range of the aircraft in nautical miles.

min_length - minimum length of the aircraft in feet.

max_length - maximum length of the aircraft in feet.

min_height - minimum height of the aircraft in feet.

max_height - maximum height of the aircraft in feet.

min_wingspan - minimum wingspan of the aircraft in feet.

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

Live Demo!

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

Sample Response

[
  {
    "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"
  }
]

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 + city, 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)
var manufacturer = 'Gulfstream'
var model = 'G550'
$.ajax({
    method: 'GET',
    url: 'https://api.api-ninjas.com/v1/aircraft?manufacturer=' + manufacturer + '&model=' + model,
    headers: { 'X-Api-Key': 'YOUR_API_KEY'},
    contentType: 'application/json',
    success: function(result) {
        console.log(result);
    },
    error: function ajaxError(jqXHR) {
        console.error('Error: ', jqXHR.responseText);
    }
});
const request = require('request');

var manufacturer = 'Gulfstream';
var model = 'G550'
request.get({
  url: 'https://api.api-ninjas.com/v1/aircraft?manufacturer=' + manufacturer + '&model=' + model,
  headers: {
    'X-Api-Key': 'YOUR_API_KEY'
  },
}, function(error, response, body) {
  if(error) return console.error('Request failed:', error);
  else if(response.statusCode != 200) return console.error('Error:', response.statusCode, body.toString('utf8'));
  else console.log(body)
});
import java.io.InputStream;
import java.net.HttpURLConnection;
import java.net.URL;

import com.fasterxml.jackson.databind.ObjectMapper;

URL url = new URL("https://api.api-ninjas.com/v1/aircraft?manufacturer=Gulfstream&model=G550");
HttpURLConnection connection = (HttpURLConnection) url.openConnection();
connection.setRequestProperty("accept", "application/json");
InputStream responseStream = connection.getInputStream();
ObjectMapper mapper = new ObjectMapper();
JsonNode root = mapper.readTree(responseStream);
System.out.println(root.path("fact").asText());
let manufacturer = "Gulfstream".addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed)
let model = "G550".addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed)
let url = URL(string: "https://api.api-ninjas.com/v1/aircraft?manufacturer="+manufacturer+"&model="+model!)!
var request = URLRequest(url: url)
request.setValue("YOUR_API_KEY", forHTTPHeaderField: "X-Api-Key")
let task = URLSession.shared.dataTask(with: request) {(data, response, error) in
    guard let data = data else { return }
    print(String(data: data, encoding: .utf8)!)
}
task.resume()
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.