Holiday Sale! Get over 30% off when you subscribe to an annual 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.

(4.2)

From 9,240 users

2,100+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
318ms361ms363ms818ms1142ms

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.

Response

Returns an array of car makes as strings (for example "Audi", "Toyota").

Sample Request Live Demo!

Try this API endpoint with all available parameters in our API playground

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 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 [ "...", "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.

Response

Returns an array of car model names as strings (for example "A4", "A4 Allroad").

Sample Request Live Demo!

make

Try this API endpoint with all available parameters in our API playground

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

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.

Response

Returns an array of car trim objects. Each object contains:

  • make

    Manufacturer name (for example Audi).

  • model

    Model name (for example A4).

  • generation

    Generation description (for example 1 generation (B5)).

  • generation_year_begin

    First production year of this generation as a string.

  • generation_year_end

    Last production year of this generation as a string (may be null).

  • serie

    Body style / series (for example Sedan, Avant wagon 5-doors).

  • trim

    Trim name (for example 1.6 AT (101 hp)).

  • trim_start_production_year

    First production year for this trim (number or null).

  • trim_end_production_year

    Last production year for this trim (number or null).

  • car_type

    High-level type of vehicle (for example car).

Sample Request Live Demo!

make
model

Try this API endpoint with all available parameters in our API playground

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

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.

Response

Returns an array of detailed car objects. Each object contains top-level fields such as:

  • make

    Manufacturer name (for example Audi).

  • model

    Model name (for example A4).

  • trim

    Trim identifier (for example 1.6 AT (101 hp)).

  • start_production_year

    First production year for this trim.

  • end_production_year

    Last production year for this trim (may be null).

  • specifications

    An object containing detailed specifications such as engine power, fuel consumption, dimensions, weight, seating capacity, and many other attributes (see sample response).

Sample Request Live Demo!

make
model
trim

Try this API endpoint with all available parameters in our API playground

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 Live Demo!

make
model

Try this API endpoint with all available parameters in our API playground

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 }, "..." ]