NewConnect Claude, Gemini, ChatGPT, and other AI agents to API Ninjas via our MCP server →

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
379ms404ms479ms876ms1265ms

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

A JSON array of strings, or an error if the request is unsuccessful.

Sample Request Live Demo!

Try our APIs in the API playground

Sign up for a free API key to get started — no credit card required.

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.

Response

A JSON array of strings, or an error if the request is unsuccessful.

Sample Request Live Demo!

make

Try our APIs in the API playground

Sign up for a free API key to get started — no credit card required.

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.

Response

A JSON array of objects, each containing the following fields, or an error if the request is unsuccessful.

  • 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 our APIs in the API playground

Sign up for a free API key to get started — no credit card required.

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.

Response

A JSON array of objects, each containing the following fields, or an error if the request is unsuccessful.

  • 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 our APIs in the API playground

Sign up for a free API key to get started — no credit card required.

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

Try our APIs in the API playground

Sign up for a free API key to get started — no credit card required.

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

Frequently Asked Questions

  • Yes, but you must have a premium subscription. Commercial use of the Cars API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.
  • Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.
  • Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.
  • The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.
  • The Cars API uses a four-step drill-down: call /v1/carmakes for the list of manufacturers, then /v1/carmodels with a make to get models, then /v1/cartrims with make and model to get trims, and finally /v1/cardetails with make, model, and trim to retrieve full specs. The /v1/carmakes, /v1/carmodels, /v1/cartrims, and /v1/cardetails endpoints require a Business, Professional, or annual subscription (see pricing).
  • Each result includes make, model, trim, start_production_year, end_production_year, and a specifications object holding dozens of attributes such as engine power, fuel consumption, dimensions, curb weight, and seating capacity. If a request is unsuccessful you will receive an error instead.
  • The /v1/cartrims endpoint accepts a limit parameter (between 1 and 100, default 30) and an offset parameter (default 0) for pagination, alongside the required make and model parameters. Each returned object includes fields like generation, serie, trim_start_production_year, and car_type; sign up at register to get started.
  • It powers automotive marketplaces, vehicle comparison tools, fleet and insurance apps, and research projects needing specs across thousands of models from over a hundred automakers. Note that the older /v1/cars endpoint is deprecated in favor of the /v1/carmakes, /v1/carmodels, /v1/cartrims, and /v1/cardetails endpoints; for EV-specific data see the Electric Vehicle API or the Motorcycles API for two-wheelers.