Cars API

The Cars API provides detailed information on thousands of vehicle models from over a hundred automakers.

Available endpoints:

/v1/carmakes - Get a list of all car manufacturers
/v1/carmodels - Get all models for a specific manufacturer
/v1/cartrims - Get all trims for a specific make and model
/v1/cardetails - Get detailed specifications for a specific make, model, and trim
/v1/cars (deprecated) - Get detailed car information by various parameters

For electric vehicle (EV)-specific data, see the Electric Vehicle API.

API Status

Online - All Systems Operational

API Response Times

Average	P50	P75	P90	P95
353ms	394ms	450ms	739ms	1256ms

Didn't find what you were looking for? Suggest an improvement

/v1/carmakes GET

Business, Professional, or annual subscriptions only

https://api.api-ninjas.com/v1/carmakes

Returns a list of all car makes (manufacturers).

Parameters

year optional
Filter manufacturers by year (e.g. 2018).

Headers

X-Api-Key required
API Key associated with your account.

Sample Request Live Demo!

https://api.api-ninjas.com/v1/carmakes

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON

[
  ...
  "Lamborghini",
  "Lancia",
  "Land Rover",
  "Landwind",
  "Leapmotor",
  "Levc",
  "Lexus",
  "Liebao Motor",
  "Lifan",
  "Ligier",
  "Lincoln",
  "Lingxi",
  "Livan",
  "Lixiang",
  "Logem",
  "Lotus",
  "Lti",
  "Luaz",
  "Lucid",
  ...
]

/v1/carmodels GET

Business, Professional, or annual subscriptions only

https://api.api-ninjas.com/v1/carmodels

Returns a list of all car models for a given make (manufacturer). Use the /v1/carmakes endpoint to get the list of makes.

Parameters

make required
Vehicle manufacturer (e.g. audi).
year optional
Vehicle model year (e.g. 2018).

Headers

X-Api-Key required
API Key associated with your account.

Sample Request Live Demo!

make

https://api.api-ninjas.com/v1/carmodels?make=Audi

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON

[
  ...
  "A4",
  "A4 Allroad",
  "A5",
  "A5 Sportback",
  "A6",
  "A6 Allroad",
  "A6 E-Tron",
  ...
]

/v1/cartrims GET

Business, Professional, or annual subscriptions only

https://api.api-ninjas.com/v1/cartrims

Returns a list of all car trims for a given make and model.

Parameters

make required
Vehicle manufacturer (e.g. audi).
model required
Vehicle model (e.g. a4). You can find the list of models by calling the /v1/carmodels endpoint.
limit optional
How many results to return. Must be between 1 and 100. Default is 30.
offset optional
Number of results to skip. Used for pagination. Default is 0.

Headers

X-Api-Key required
API Key associated with your account.

Sample Request Live Demo!

make

model

https://api.api-ninjas.com/v1/cartrims?make=Audi&model=A4

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON

[
  {
    "make": "Audi",
    "model": "A4",
    "generation": "1 generation (B5)",
    "generation_year_begin": "1994",
    "generation_year_end": "1999",
    "serie": "Sedan",
    "trim": "1.6 AT (101 hp)",
    "trim_start_production_year": 1994,
    "trim_end_production_year": 1997,
    "car_type": "car"
  },
  {
    "make": "Audi",
    "model": "A4",
    "generation": "1 generation (B5)",
    "generation_year_begin": "1994",
    "generation_year_end": "1999",
    "serie": "Avant wagon 5-doors",
    "trim": "1.6 AT (101 hp)",
    "trim_start_production_year": null,
    "trim_end_production_year": null,
    "car_type": "car"
  },
  ...
]

/v1/cardetails GET

Business, Professional, or annual subscriptions only

https://api.api-ninjas.com/v1/cardetails

Returns detailed specifications matching a given make, model, and trim combination.

Parameters

make required
Vehicle manufacturer (e.g. audi).
model required
Vehicle model (e.g. a4). You can find the list of models by calling the /v1/carmodels endpoint.
trim required
Vehicle trim (e.g. 1.6 AT (101 hp)). You can find the list of trims by calling the /v1/cartrims endpoint.

Headers

X-Api-Key required
API Key associated with your account.

Sample Request Live Demo!

make

model

trim

https://api.api-ninjas.com/v1/cardetails?make=Audi&model=A4&trim=1.6%20AT%20(101%20hp)

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON

[
  {
    "make": "Audi",
    "model": "A4",
    "trim": "1.6 AT (101 hp)",
    "start_production_year": 1994,
    "end_production_year": 1997,
    "specifications": {
      "Acceleration (0-100 km/h)": "14.6 s",
      "Back suspension": "Semi-dependent, Multi wishbone, spring, Stabilizer bar",
      "Body type": "Sedan",
      "Capacity": "1595 cm3",
      "City driving fuel consumption per 100 km": "11.8 l",
      "Cruising range": "from 530 to 980 km",
      "Curb weight": "1255 kg",
      "Cylinder bore": "81 mm",
      "Cylinder layout": "Inline",
      "Drive wheels": "Front wheel drive",
      "Engine power": "101 hp",
      "Engine type": "Gasoline",
      "Front brakes": "ventilated disc",
      "Front suspension": "Independent, Multi wishbone, spring, Stabilizer bar",
      "Front track": "1498 mm",
      "Fuel": "95",
      "Fuel tank capacity": "62 l",
      "Full weight": "1805 kg",
      "Gearbox type": "Automatic",
      "Ground clearance": "110 mm",
      "Height": "1415 mm",
      "Highway driving fuel consumption per 100 km": "6.3 l",
      "Injection type": "Multi-point fuel injection",
      "Length": "4479 mm",
      "Max power at RPM": "to 5 300 RPM",
      "Max speed": "185 km/h",
      "Max trunk capacity": "440 l",
      "Maximum torque": "140 N*m",
      "Min trunk capacity": "440 l",
      "Mixed driving fuel consumption per 100 km": "7.5 l",
      "Number of cylinders": "4",
      "Number of gear": "4",
      "Number of seater": "5",
      "Payload": "550 kg",
      "Rear brakes": "Disc",
      "Rear track": "1479 mm",
      "Stroke cycle": "77.4 mm",
      "Turning circle": "11.1 m",
      "Turnover of maximum torque": "to 3 800 RPM",
      "Valves per cylinder": "2",
      "Wheelbase": "2617 mm",
      "Width": "1733 mm"
    }
  },
  ...
]

/v1/cars GETDeprecated

https://api.api-ninjas.com/v1/cars

Get car data from given parameters. Returns a list of car models (and their information) that satisfy the parameters.

Parameters

make required
Vehicle manufacturer (e.g. audi).
model required
Vehicle model (e.g. a4). You can find the list of models by calling the /v1/carmodels endpoint.
trim required
Vehicle trim (e.g. 1.6 AT (101 hp)). You can find the list of trims by calling the /v1/cartrims endpoint.

Headers

X-Api-Key required
API Key associated with your account.

Sample Request Live Demo!

make

model

https://api.api-ninjas.com/v1/cars?make=Audi&model=A4

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON

[
  {
    "city_mpg": 16,
    "class": "compact car",
    "combination_mpg": 19,
    "cylinders": 6,
    "displacement": 2.8,
    "drive": "fwd",
    "fuel_type": "gas",
    "highway_mpg": 26,
    "make": "audi",
    "model": "a4",
    "transmission": "a",
    "year": 1996
  }
  ...
]

Cars API

/v1/carmakes GET

Parameters

year optional

Headers

X-Api-Key required

Sample Request Live Demo!

Sample Response

/v1/carmodels GET

Parameters

make required

year optional

Headers

X-Api-Key required

Sample Request Live Demo!

Sample Response

/v1/cartrims GET

Parameters

make required

model required

limit optional

offset optional

Headers

X-Api-Key required

Sample Request Live Demo!

Sample Response

/v1/cardetails GET

Parameters

make required

model required

trim required

Headers

X-Api-Key required

Sample Request Live Demo!

Sample Response

/v1/cars GETDeprecated

Parameters

make required

model required

trim required

Headers

X-Api-Key required

Sample Request Live Demo!

Sample Response

`year` optional

`X-Api-Key` required

`make` required

`year` optional

`X-Api-Key` required

`make` required

`model` required

`limit` optional

`offset` optional

`X-Api-Key` required

`make` required

`model` required

`trim` required

`X-Api-Key` required

`make` required

`model` required

`trim` required

`X-Api-Key` required