Cars API logo
DataMAINTAINED1 token / call

Cars API

EPA fuel economy and specs for 50,000 US vehicles since 1984: MPG, CO2, EV range and annual fuel cost

US vehicle catalog and fuel-economy specs for 50,000+ vehicles, model years 1984 through the upcoming one — make, model, year, EPA size class, drive, transmission, engine details (cylinders, displacement, turbo/supercharger, start-stop), fuel types including hybrid, plug-in hybrid and EV, city/highway/combined MPG (MPGe for electric vehicles), CO2 grams per mile, greenhouse-gas score, annual fuel cost, 5-year savings vs the average car, EV range and 240V charge time, and gas-guzzler-tax flag. Filter by make, model, year range, vehicle class, drive, fuel, cylinders, minimum MPG or electric-only; aggregate makes and models per year. Self-hosted dataset built from official EPA fueleconomy.gov data, refreshed daily — no third-party calls.

Every call needs an X-Api-Key header. A free key includes 500 tokens a month, no card required. 1 token per call, so the free plan covers about 500 calls a month.

No credit card requiredAccess to 125+ APIsCancel anytime
response.json
{
  "total": 50242,
  "count": 1,
  "results": [
    {
      "id": 49177,
      "year": 2026,
      "make": "Toyota",
      "model": "GR Supra",
      "vehicleClass": "Two Seaters",
      "mpg": {
        "city": 25,
        "highway": 31,
        "combined": 27
      },
      "engine": {
        "cylinders": 4,
        "displacementL": 2,
        "turbocharger": true
      }
    }
  ]
}
Production Ready
Battle-tested infrastructure with a 99.9% uptime SLA. Rate limits are generous, responses are consistent.
Simple Integration
Standard REST + JSON. Works with any HTTP client. Copy-ready code snippets in 4 languages.
One Key, 125+ APIs
Your DataAndAPIs subscription unlocks every API on the platform — anime, finance, sports, and more.

Use cases for Cars API

  • Show MPG or MPGe, CO2 and annual fuel cost on car listings and comparison tools.

  • Populate make, model and year pickers from the official catalogue, including the upcoming model year.

  • Filter EVs and plug-in hybrids by range and 240V charge time for a buyer's guide.

  • Join a decoded VIN's year, make and model to its official economy figures.

Cars API endpoints

Every endpoint with its parameters and a real example response.

GETGet Vehicle

https://api-cars.dataandapis.com/v1/vehicles/{id}

Path parameters

ParameterExample
id49177Required

Example request

curl
curl "https://api-cars.dataandapis.com/v1/vehicles/49177" \
  -H "X-Api-Key: YOUR_API_KEY"
JavaScript / TypeScript (dataandapis package)
// npm install dataandapis
import { DataAndApis } from "dataandapis";

const client = new DataAndApis(); // reads DATAANDAPIS_API_KEY

const data = await client.cars.getVehicle({ id: 49177 });
Example response
{
  "id": 49177,
  "year": 2026,
  "make": "Toyota",
  "model": "GR Supra",
  "vehicleClass": "Two Seaters",
  "drive": "Rear-Wheel Drive",
  "transmission": "Automatic (S8)",
  "engine": {
    "cylinders": 4,
    "displacementL": 2,
    "description": "SIDI",
    "turbocharger": true,
    "supercharger": false,
    "startStop": true
  },
  "fuel": {
    "type": "Premium",
    "primary": "Premium Gasoline",
    "alternative": null
  },
  "mpg": {
    "city": 25,
    "highway": 31,
    "combined": 27
  },
  "emissions": {
    "co2GramsPerMile": 322,
…
Show full response
{
  "id": 49177,
  "year": 2026,
  "make": "Toyota",
  "model": "GR Supra",
  "vehicleClass": "Two Seaters",
  "drive": "Rear-Wheel Drive",
  "transmission": "Automatic (S8)",
  "engine": {
    "cylinders": 4,
    "displacementL": 2,
    "description": "SIDI",
    "turbocharger": true,
    "supercharger": false,
    "startStop": true
  },
  "fuel": {
    "type": "Premium",
    "primary": "Premium Gasoline",
    "alternative": null
  },
  "mpg": {
    "city": 25,
    "highway": 31,
    "combined": 27
  },
  "emissions": {
    "co2GramsPerMile": 322,
    "ghgScore": 5
  },
  "cost": {
    "fuelPerYear": 2800,
    "barrelsPerYear": 11.02,
    "youSaveSpend5Year": -3000
  },
  "ev": {
    "rangeMiles": null,
    "rangeCity": null,
    "rangeHighway": null,
    "motor": null,
    "hoursToCharge240v": null
  },
  "guzzlerTax": false,
  "epaCreatedOn": "Thu Sep 25 00:00:00 EDT 2025",
  "epaModifiedOn": "Tue Oct 28 00:00:00 EDT 2025"
}

GETList Vehicles

https://api-cars.dataandapis.com/v1/vehicles

Query parameters

ParameterExample
classTwo SeatersOptional
cylinders6Optional
driveAll-WheelOptional
electrictrueOptional
fuelElectricityOptional
limit20Optional
makeToyotaOptional
maxYear2027Optional
minCombinedMpg30Optional
minYear2020Optional
model4RunnerOptional
page1Optional
qsupraOptional
year2026Optional

Example request

curl
curl "https://api-cars.dataandapis.com/v1/vehicles?class=Two%20Seaters&cylinders=6&drive=All-Wheel&electric=true&fuel=Electricity&limit=20&make=Toyota&maxYear=2027&minCombinedMpg=30&minYear=2020&model=4Runner&page=1&q=supra&year=2026" \
  -H "X-Api-Key: YOUR_API_KEY"
JavaScript / TypeScript (dataandapis package)
// npm install dataandapis
import { DataAndApis } from "dataandapis";

const client = new DataAndApis(); // reads DATAANDAPIS_API_KEY

const data = await client.cars.listVehicles({
  class: "Two Seaters",
  cylinders: 6,
  drive: "All-Wheel",
  electric: true,
  fuel: "Electricity",
  limit: 20,
  make: "Toyota",
  maxYear: 2027,
  minCombinedMpg: 30,
  minYear: 2020,
  model: "4Runner",
  page: 1,
  q: "supra",
  year: 2026,
});
Example response
{
  "total": 92,
  "page": 1,
  "limit": 20,
  "count": 1,
  "results": [
    {
      "id": 49123,
      "year": 2026,
      "make": "Toyota",
      "model": "4Runner 2WD",
      "vehicleClass": "Standard Sport Utility Vehicle 2WD",
      "drive": "Rear-Wheel Drive",
      "transmission": "Automatic (S8)",
      "engine": {
        "cylinders": 4,
        "displacementL": 2.4,
        "description": "SIDI",
        "turbocharger": true,
        "supercharger": false,
        "startStop": true
      },
      "fuel": {
        "type": "Regular",
        "primary": "Regular Gasoline",
        "alternative": null
      },
      "mpg": {
…
Show full response
{
  "total": 92,
  "page": 1,
  "limit": 20,
  "count": 1,
  "results": [
    {
      "id": 49123,
      "year": 2026,
      "make": "Toyota",
      "model": "4Runner 2WD",
      "vehicleClass": "Standard Sport Utility Vehicle 2WD",
      "drive": "Rear-Wheel Drive",
      "transmission": "Automatic (S8)",
      "engine": {
        "cylinders": 4,
        "displacementL": 2.4,
        "description": "SIDI",
        "turbocharger": true,
        "supercharger": false,
        "startStop": true
      },
      "fuel": {
        "type": "Regular",
        "primary": "Regular Gasoline",
        "alternative": null
      },
      "mpg": {
        "city": 20,
        "highway": 26,
        "combined": 22
      },
      "emissions": {
        "co2GramsPerMile": 404,
        "ghgScore": 4
      },
      "cost": {
        "fuelPerYear": 2100,
        "barrelsPerYear": 13.5,
        "youSaveSpend5Year": -750
      },
      "ev": {
        "rangeMiles": null,
        "rangeCity": null,
        "rangeHighway": null,
        "motor": null,
        "hoursToCharge240v": null
      },
      "guzzlerTax": false
    }
  ]
}

GETRandom Vehicles

https://api-cars.dataandapis.com/v1/vehicles/random

Query parameters

ParameterExample
amount3Optional

Example request

curl
curl "https://api-cars.dataandapis.com/v1/vehicles/random?amount=3" \
  -H "X-Api-Key: YOUR_API_KEY"
JavaScript / TypeScript (dataandapis package)
// npm install dataandapis
import { DataAndApis } from "dataandapis";

const client = new DataAndApis(); // reads DATAANDAPIS_API_KEY

const data = await client.cars.randomVehicles({ amount: 3 });
Example response
{
  "count": 2,
  "results": [
    {
      "id": 41234,
      "year": 2020,
      "make": "Kia",
      "model": "Sorento FWD",
      "vehicleClass": "Small Sport Utility Vehicle 2WD",
      "mpg": {
        "city": 22,
        "highway": 29,
        "combined": 25
      }
    },
    {
      "id": 43567,
      "year": 2021,
      "make": "Mercedes-Benz",
      "model": "AMG GLE53 4matic Plus Coupe",
      "vehicleClass": "Standard Sport Utility Vehicle 4WD",
      "mpg": {
        "city": 18,
        "highway": 23,
        "combined": 20
      }
    }
  ]
…
Show full response
{
  "count": 2,
  "results": [
    {
      "id": 41234,
      "year": 2020,
      "make": "Kia",
      "model": "Sorento FWD",
      "vehicleClass": "Small Sport Utility Vehicle 2WD",
      "mpg": {
        "city": 22,
        "highway": 29,
        "combined": 25
      }
    },
    {
      "id": 43567,
      "year": 2021,
      "make": "Mercedes-Benz",
      "model": "AMG GLE53 4matic Plus Coupe",
      "vehicleClass": "Standard Sport Utility Vehicle 4WD",
      "mpg": {
        "city": 18,
        "highway": 23,
        "combined": 20
      }
    }
  ]
}

GETVehicle Makes

https://api-cars.dataandapis.com/v1/vehicles/makes

Query parameters

ParameterExample
year2026Optional

Example request

curl
curl "https://api-cars.dataandapis.com/v1/vehicles/makes?year=2026" \
  -H "X-Api-Key: YOUR_API_KEY"
JavaScript / TypeScript (dataandapis package)
// npm install dataandapis
import { DataAndApis } from "dataandapis";

const client = new DataAndApis(); // reads DATAANDAPIS_API_KEY

const data = await client.cars.vehicleMakes({ year: 2026 });
Example response
{
  "count": 46,
  "makes": [
    {
      "make": "BMW",
      "count": 108
    },
    {
      "make": "Toyota",
      "count": 92
    },
    {
      "make": "Mercedes-Benz",
      "count": 76
    },
    {
      "make": "Chevrolet",
      "count": 68
    }
  ]
}

GETVehicle Models

https://api-cars.dataandapis.com/v1/vehicles/models

Query parameters

ParameterExample
makePorscheRequired
year2026Optional

Example request

curl
curl "https://api-cars.dataandapis.com/v1/vehicles/models?make=Porsche&year=2026" \
  -H "X-Api-Key: YOUR_API_KEY"
JavaScript / TypeScript (dataandapis package)
// npm install dataandapis
import { DataAndApis } from "dataandapis";

const client = new DataAndApis(); // reads DATAANDAPIS_API_KEY

const data = await client.cars.vehicleModels({ make: "Porsche", year: 2026 });
Example response
{
  "count": 55,
  "make": "Porsche",
  "models": [
    {
      "model": "911 Carrera",
      "firstYear": 2026,
      "lastYear": 2026,
      "count": 1
    },
    {
      "model": "911 Carrera 4 GTS",
      "firstYear": 2026,
      "lastYear": 2026,
      "count": 1
    },
    {
      "model": "Macan 4 Electric",
      "firstYear": 2026,
      "lastYear": 2026,
      "count": 1
    }
  ]
}

Where the data comes from

Source
US EPA fuel economy data from fueleconomy.gov (public domain).
Freshness
Daily upsert of EPA changes.

One install. Every endpoint.

Install the dataandapis package from npm and call this API with typed methods, or use any HTTP client in the language you prefer.

4languages
5endpoints
RESTarchitecture
1key for all APIs
  • Typed parameters and responses, with auto-completion in your editor
  • Works with import and require on Node.js 18 or later, with no dependencies
  • One key works across 125+ APIs on the platform

Read the npm package guide →

// npm install dataandapis
import { DataAndApis } from "dataandapis";

const client = new DataAndApis(); // reads DATAANDAPIS_API_KEY

const data = await client.cars.getVehicle({ id: 49177 });

Cars API · X-Api-Key

Explore the endpoints

Browse request parameters and inspect live example responses.

Available Endpoints

Request Parameters

API URL

Headers

X-Api-Key

Path Parameters

id
// npm install dataandapis
import { DataAndApis } from "dataandapis";

const client = new DataAndApis({ apiKey: "YOUR_API_KEY" });

const data = await client.cars.getVehicle({ id: 49177 });

One subscription. Every API.

Tokens unlock this API and 125+ others on DataAndAPIs. Switch APIs any time — we promote.

FREE

$0/mo

500 tokens / month

  • Access to all APIs
  • Tokens reset monthly
  • Community support
Start free
Most Popular

STARTER

$6.99/mo

25,000 tokens / month

  • Access to all APIs
  • Tokens reset monthly
  • Email support
Subscribe

PRO

$24.99/mo

100,000 tokens / month

  • Access to all APIs
  • Tokens reset monthly
  • Priority email support
Subscribe

ULTRA

$99.99/mo

1,000,000 tokens / month

  • Access to all APIs
  • Tokens reset monthly
  • Priority support
Subscribe

Need higher volume, dedicated infra, or a custom contract? Talk to sales →

Questions about Cars API

Ship Cars API this afternoon.

500 free tokens. No card. Plus 125+ other APIs on the same key.