This is a searchable car database with 40,000+ entries from 1987-2021 (updated 9/14/2020). Includes data items like make, model, year, transmission type, fuel economy data, etc. There are two different formats you can download the dataset in, JSON and CSV. There is also a link to a react app that utilizes the data along with PouchDb to create a browser based database with indexing.
Note: The dataset that is used to populate the database for the search webapp takes awhile to load into browser memory and create indexes on
All data is from fueleconomy.gov and you may download this dataset from their website too.
parser.py is used to transform the data from CSV to JSON format. Use parser.py --help to see a list of required inputs
pip install pipenv
pipenv shell
pipenv install
python parser.py [args]The react app and accompanying database is under vehicle-search/
To get the react app up and running, follow the README found under vehicle-search/
- PouchDb - The database that houses the 40,000+ entries in browser
This project is licensed under the MIT License - see the LICENSE.md file for details
This is the list of descriptions for the csv headers
atvtype - type of alternative fuel or advanced technology vehicle
barrels08 - annual petroleum consumption in barrels for fuelType1 (1)
barrelsA08 - annual petroleum consumption in barrels for fuelType2 (1)
charge120 - time to charge an electric vehicle in hours at 120 V
charge240 - time to charge an electric vehicle in hours at 240 V
city08 - city MPG for fuelType1 (2), (11)
city08U - unrounded city MPG for fuelType1 (2), (3)
cityA08 - city MPG for fuelType2 (2)
cityA08U - unrounded city MPG for fuelType2 (2), (3)
cityCD - city gasoline consumption (gallons/100 miles) in charge depleting mode (4)
cityE - city electricity consumption in kw-hrs/100 miles
cityUF - EPA city utility factor (share of electricity) for PHEV
co2 - tailpipe CO2 in grams/mile for fuelType1 (5)
co2A - tailpipe CO2 in grams/mile for fuelType2 (5)
co2TailpipeAGpm - tailpipe CO2 in grams/mile for fuelType2 (5)
co2TailpipeGpm- tailpipe CO2 in grams/mile for fuelType1 (5)
comb08 - combined MPG for fuelType1 (2), (11)
comb08U - unrounded combined MPG for fuelType1 (2), (3)
combA08 - combined MPG for fuelType2 (2)
combA08U - unrounded combined MPG for fuelType2 (2), (3)
combE - combined electricity consumption in kw-hrs/100 miles
combinedCD - combined gasoline consumption (gallons/100 miles) in charge depleting mode (4)
combinedUF - EPA combined utility factor (share of electricity) for PHEV
cylinders - engine cylinders
displ - engine displacement in liters
drive - drive axle type
emissionsList
engId - EPA model type index
eng_dscr - engine descriptor; see http://www.fueleconomy.gov/feg/findacarhelp.shtml#engine
evMotor - electric motor (kw-hrs)
feScore - EPA Fuel Economy Score (-1 = Not available)
fuelCost08 - annual fuel cost for fuelType1 ($) (7)
fuelCostA08 - annual fuel cost for fuelType2 ($) (7)
fuelType - fuel type with fuelType1 and fuelType2 (if applicable)
fuelType1 - fuel type 1. For single fuel vehicles, this will be the only fuel. For dual fuel vehicles, this will be the conventional fuel.
fuelType2 - fuel type 2. For dual fuel vehicles, this will be the alternative fuel (e.g. E85, Electricity, CNG, LPG). For single fuel vehicles, this field is not used
ghgScore - EPA GHG score (-1 = Not available)
ghgScoreA - EPA GHG score for dual fuel vehicle running on the alternative fuel (-1 = Not available)
guzzler- if G or T, this vehicle is subject to the gas guzzler tax
highway08 - highway MPG for fuelType1 (2), (11)
highway08U - unrounded highway MPG for fuelType1 (2), (3)
highwayA08 - highway MPG for fuelType2 (2)
highwayA08U - unrounded highway MPG for fuelType2 (2),(3)
highwayCD - highway gasoline consumption (gallons/100miles) in charge depleting mode (4)
highwayE - highway electricity consumption in kw-hrs/100 miles
highwayUF - EPA highway utility factor (share of electricity) for PHEV
hlv - hatchback luggage volume (cubic feet) (8)
hpv - hatchback passenger volume (cubic feet) (8)
id - vehicle record id
lv2 - 2 door luggage volume (cubic feet) (8)
lv4 - 4 door luggage volume (cubic feet) (8)
make - manufacturer (division)
mfrCode - 3-character manufacturer code
model - model name (carline)
mpgData - has My MPG data; see yourMpgVehicle and yourMpgDriverVehicle
phevBlended - if true, this vehicle operates on a blend of gasoline and electricity in charge depleting mode
pv2 - 2-door passenger volume (cubic feet) (8)
pv4 - 4-door passenger volume (cubic feet) (8)
rangeA - EPA range for fuelType2
rangeCityA - EPA city range for fuelType2
rangeHwyA - EPA highway range for fuelType2
trans_dscr - transmission descriptor; see http://www.fueleconomy.gov/feg/findacarhelp.shtml#trany
trany - transmission
UCity - unadjusted city MPG for fuelType1; see the description of the EPA test procedures
UCityA - unadjusted city MPG for fuelType2; see the description of the EPA test procedures
UHighway - unadjusted highway MPG for fuelType1; see the description of the EPA test procedures
UHighwayA - unadjusted highway MPG for fuelType2; see the description of the EPA test procedures
VClass - EPA vehicle size class
year - model year
youSaveSpend - you save/spend over 5 years compared to an average car ($). Savings are positive; a greater amount spent yields a negative number. For dual fuel vehicles, this is the cost savings for gasoline
sCharger - if S, this vehicle is supercharged
tCharger - if T, this vehicle is turbocharged
c240Dscr - electric vehicle charger description
charge240b - time to charge an electric vehicle in hours at 240 V using the alternate charger
c240bDscr - electric vehicle alternate charger description
createdOn - date the vehicle record was created (ISO 8601 format)
modifiedOn - date the vehicle record was last modified (ISO 8601 format)
startStop - vehicle has start-stop technology (Y, N, or blank for older vehicles)
phevCity - EPA composite gasoline-electricity city MPGe for plug-in hybrid vehicles
phevHwy - EPA composite gasoline-electricity highway MPGe for plug-in hybrid vehicles
phevComb - EPA composite gasoline-electricity combined city-highway MPGe for plug-in hybrid vehicles