Fuel Economy & Vehicle Specs Scraper (EPA FuelEconomy.gov)

Extract official EPA fuel economy ratings, engine specifications, emissions scores, and annual fuel cost estimates from the US Department of Energy's FuelEconomy.gov database. Covers every vehicle sold in the United States from 1984 to 2027, including electric vehicles, hybrids, and plug-in hybrids.

No API key required. Data is 100% free and publicly available.

What You Get

Each scraped record contains:

Field	Description
vehicleId	Unique FuelEconomy.gov vehicle ID
url	Direct link to the vehicle's fuel economy comparison page
year	Model year
make	Vehicle manufacturer (e.g. Toyota, Ford)
model	Model name (e.g. Camry, F-150)
baseModel	Base model name without trim
vehicleClass	EPA vehicle class (e.g. Midsize Cars, SUV, Pickup Trucks)
drive	Drivetrain (FWD, RWD, AWD, 4WD)
transmission	Transmission type (e.g. Automatic (S8))
cylinders	Number of engine cylinders
displacement	Engine displacement in liters
engineDescription	Engine technology description
fuelType	Primary fuel type
fuelType2	Secondary fuel type (PHEVs / FFVs)
mpgCity	City fuel economy (MPG)
mpgHighway	Highway fuel economy (MPG)
mpgCombined	Combined fuel economy (MPG)
mpgeCityAlt	City MPGe for alternative fuel (EVs / PHEVs)
mpgeHwyAlt	Highway MPGe for alternative fuel
mpgeCombinedAlt	Combined MPGe for alternative fuel
co2GramsPerMile	CO₂ tailpipe emissions in grams per mile
fuelEconomyScore	EPA fuel economy score (1–10)
ghgScore	Greenhouse gas score (1–10)
annualFuelCostUsd	Estimated annual fuel cost in USD
evMotor	Electric motor description (EVs)
electricRange	All-electric range in miles (EVs / PHEVs)
chargeTime240vHours	Time to charge on 240V Level 2 charger (hours)
phevCombinedMpge	PHEV combined MPGe
turbocharged	True if turbocharged
supercharged	True if supercharged
hasStartStopTechnology	True if equipped with start-stop
scrapedAt	ISO 8601 timestamp

Input Options

Mode: Search Vehicles

Search by make + model + optional year. Returns all trim variants.

{
  "mode": "search",
  "make": "Toyota",
  "model": "Camry",
  "year": 2023,
  "maxItems": 50
}

Omit year to get all model years for that make/model combination.

Mode: Browse All Models for a Make

Get every vehicle variant ever produced by a manufacturer, with optional year range.

{
  "mode": "makeModels",
  "make": "Tesla",
  "yearMin": 2017,
  "yearMax": 2024,
  "maxItems": 200
}

Mode: List All Makes

Get a list of all manufacturers with vehicles in the EPA database for a given year.

{
  "mode": "allMakes",
  "queryYear": 2023,
  "maxItems": 100
}

Mode: Fetch by Vehicle ID

Fetch specific vehicles by their FuelEconomy.gov ID (found in the URL on the website).

{
  "mode": "byVehicleId",
  "vehicleIds": ["45719", "45726", "45720"]
}

Filters

Use fuelTypeFilter and driveTrainFilter to narrow results:

{
  "mode": "search",
  "make": "Ford",
  "model": "F-150",
  "fuelTypeFilter": "Regular Gasoline",
  "driveTrainFilter": "4-Wheel Drive",
  "maxItems": 50
}

Use Cases

• Car shopping research: Compare EPA-verified MPG ratings across makes, models, and years
• Fleet management: Identify fuel-efficient vehicles by class and drivetrain
• Environmental analysis: Study CO₂ emissions and GHG scores by vehicle segment
• EV research: Find electric vehicle range and charging time specifications
• Market research: Track which manufacturers offer the most fuel-efficient lineups
• Academic research: Build datasets of vehicle emissions for climate studies

Data Source

Data comes from the US Department of Energy's FuelEconomy.gov public REST API — the official source for EPA fuel economy testing results. Coverage includes:

• All model years from 1984 to 2027
• 50+ manufacturers in recent years
• Conventional, hybrid, plug-in hybrid, battery electric, fuel cell, and flex-fuel vehicles

FAQ

Is an API key required? No. FuelEconomy.gov is a free US government open data service with no authentication required.

How current is the data? The EPA tests and publishes data for each new model year. 2026 and 2027 model year data may be partial (pre-production estimates).

Can I get historical data back to 1984? Yes — set yearMin: 1984 in makeModels mode to retrieve the full history for any manufacturer.

What's the difference between MPG and MPGe? MPG (miles per gallon) is for conventional fuel. MPGe (miles per gallon equivalent) is used for electric vehicles, measuring equivalent energy in terms of gasoline.

Why are some EV records missing city/highway MPG? For pure electric vehicles, the primary fuel economy metrics appear in mpgeCityAlt and mpgeHwyAlt (the alternative fuel columns), while mpgCity/mpgHighway are zero and omitted.