Save over 30% when you subscribe to an annual subscription plan!

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.

/v1/carmakes GET

Annual premium 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

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

Headers

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

Sample Response

JSON
1 2 3 4 5 6 7 8 [ ... "Lamborghini", "Land Rover", "Lexus", "Lincoln", ... ]

/v1/carmodels GET

Annual premium subscriptions only

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

Returns a list of all car models for a given make (manufacturer).


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

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
1 2 3 4 5 6 7 8 9 10 11 [ ... "A4", "A4 Allroad", "A5", "A5 Sportback", "A6", "A6 Allroad", "A6 E-Tron", ... ]

/v1/cartrims GET

Annual premium 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

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
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 [ { "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

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

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
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 [ { "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

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
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 [ { "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 } ... ]