list-of-cars

list of car / automobile makes and models 1992-2020.

based on a public domain dataset compiled by Abhilash Reddy.

includes 9581 car models from 62 makes.

Installation

npm i list-of-cars

Usage - async

var loc = require('list-of-cars');

//first, call getList to decompress the dataset
loc.getList(function(res){ 
    console.log(res); //full list
    console.log(loc.getCarMakes());
    console.log(loc.getCarsByMakeObj());
    console.log(loc.getCarCategories());
    console.log(loc.getCarsByCategoryObj());
})

see results below

Usage - sync

//first, call getListSync to decompress the dataset
var fullList = loc.getListSync()

console.log(loc.getCarMakes());
console.log(loc.getCarCategories());
console.log(loc.getCarsByMakeObj());
console.log(loc.getCarsByCategoryObj());

Result:

/*
full dataset -- list of models:
[
  { Year: 2020, Make: 'Audi', Model: 'Q3', Category: 'SUV' },
  { Year: 2020, Make: 'Chevrolet', Model: 'Malibu', Category: 'Sedan' },
 ...
    ~9500 more items
]
 */

/*
list of makes:
[
  'Audi',         'Chevrolet',    'Cadillac',    'Acura',
  'BMW',          'Chrysler',     'Ford',        'Buick',
  'INFINITI',     'GMC',          'Honda',       'Hyundai',
  'Jeep',         'Genesis',      'Dodge',       'Jaguar',
  'Kia',          'Land Rover',   'Lexus',       'Mercedes-Benz',
  'Mitsubishi',   'Lincoln',      'MAZDA',       'Nissan',
  'MINI',         'Porsche',      'Ram',         'Subaru',
  'Toyota',       'Volkswagen',   'Volvo',       'Alfa Romeo',
  'FIAT',         'Freightliner', 'Maserati',    'Tesla',
  'Aston Martin', 'Bentley',      'Ferrari',     'Lamborghini',
  'Lotus',        'McLaren',      'Rolls-Royce', 'smart',
  'Scion',        'SRT',          'Suzuki',      'Fisker',
  'Maybach',      'Mercury',      'Saab',        'HUMMER',
  'Pontiac',      'Saturn',       'Isuzu',       'Panoz',
  'Oldsmobile',   'Daewoo',       'Plymouth',    'Eagle',
  'Geo',          'Daihatsu'
]
 */

/*
categories -- note some cars span multiple categories
[
  'SUV',
  'Sedan',
  'Coupe, Convertible',
  'Pickup',
  'Van/Minivan',
  'Convertible',
  'Hatchback, Sedan, Coupe',
...
]
 */