EV Database APIev-database.org ↗
Access EV specs, range, battery, pricing, and charging data for all electric vehicles listed on ev-database.org via a structured REST API.
What is the EV Database API?
The EV Database API exposes 6 endpoints covering technical specifications, pricing across European markets, charging scenarios, and images for every electric vehicle listed on ev-database.org. The list_vehicles endpoint returns the full catalogue with per-country pricing and summary specs in a single call, while get_vehicle_detail provides battery capacity, performance figures, and charging table data for a specific vehicle identified by its id and slug.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/595979b5-42f9-45fa-8d07-bf3264b76b03/list_vehicles' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace ev-database-org-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.ev_database_api import EVDatabase, Vehicle, VehicleDetail, Make, CheatsheetMetric
evdb = EVDatabase()
# Search for Tesla vehicles
for vehicle in evdb.vehicles.search(query="Tesla", limit=5):
print(vehicle.name, vehicle.range, vehicle.efficiency, vehicle.prices)
# Get the ranked list by efficiency
for vehicle in evdb.vehicles.ranked(metric=CheatsheetMetric.EFFICIENCY, limit=3):
print(vehicle.name, vehicle.efficiency, vehicle.battery)
# List all manufacturers
for make in evdb.makes.list():
print(make.name)
# Get detailed specs for a specific vehicle (constructible by id)
tesla = Vehicle(_api=evdb, id="3403", slug="Tesla-Model-3-RWD")
detail = tesla.details()
print(detail.name, detail.price, detail.performance)
# Access images sub-resource
for img in tesla.images.list():
print(img.url)
Retrieve all electric vehicles in the database with summary data including name, ID, slug, specs (range, efficiency, weight, acceleration, battery, fast-charge rate, towing capacity, cargo volume), and pricing across countries. Returns all vehicles in a single page. Each vehicle carries an id and slug needed by get_vehicle_detail and get_vehicle_images.
No input parameters required.
{
"type": "object",
"fields": {
"total": "integer total count of vehicles",
"vehicles": "array of vehicle summary objects"
},
"sample": {
"data": {
"total": 1364,
"vehicles": [
{
"id": "3403",
"url": "https://ev-database.org/car/3403/Tesla-Model-3-RWD",
"name": "Tesla Model 3 RWD",
"slug": "Tesla-Model-3-RWD",
"0_100": "6.2 sec",
"range": "450 km",
"prices": {
"de": "€37,970",
"gb": "£37,990",
"nl": "€36,990"
},
"towing": "1,000 kg",
"weight": "1,847 kg",
"battery": "60.0 kWh",
"cargo_vol.": "682 L",
"efficiency": "133 Wh/km",
"fastcharge": "110 kW",
"price/range": "€88 /km",
"1_stop_range": "533 km"
}
]
},
"status": "success"
}
}About the EV Database API
Vehicle Discovery and Search
list_vehicles returns the complete database in one response, including each vehicle's id, slug, name, url, country-specific prices, and summary specs. This forms the foundation for any downstream lookup: both id and slug are required inputs for the detail and image endpoints. search_vehicles accepts a free-text query string and performs a case-insensitive substring match against vehicle names, making it straightforward to retrieve, for example, all Tesla or all Hyundai models in a single filtered response. list_makes returns an alphabetically sorted array of all manufacturer names in the database.
Detailed Specifications and Charging Data
get_vehicle_detail returns a structured object broken into four main sections: Price (country-specific pricing), Battery (capacity, type, and related figures), Performance (acceleration, top speed, and similar metrics), and charging_scenarios (standard and fast charging table data). These charging tables are particularly useful for applications that need to compare real-world charge time estimates across different charging speeds for a given vehicle.
Rankings and Images
get_cheatsheet ranks all vehicles by a chosen metric — accepted values are efficiency, range, battery, fastcharge, acceleration, and price — and returns the full sorted vehicle list. This makes it possible to generate leaderboards or comparisons without sorting client-side. get_vehicle_images returns an array of image URL strings for a given vehicle, identified by the same id and slug pair used throughout the API.
The EV Database API is a managed, monitored endpoint for ev-database.org — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when ev-database.org changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official ev-database.org API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build an EV comparison tool that ranks vehicles by range or efficiency using the
get_cheatsheetendpoint. - Populate a European new-car pricing database with country-specific EV prices from
list_vehicles. - Display a vehicle profile page with full battery, performance, and charging spec tables from
get_vehicle_detail. - Create a manufacturer directory by iterating over the
makesarray fromlist_makes. - Implement an autocomplete search for EV models using
search_vehicleswith aquerystring. - Render a vehicle image gallery by fetching the
imagesarray fromget_vehicle_images. - Generate fast-charging comparison tables across models using the
charging_scenariosdata inget_vehicle_detail.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does ev-database.org have an official developer API?+
What does `get_cheatsheet` return, and how do I choose which metric to rank by?+
type parameter. Accepted values are efficiency, range, battery, fastcharge, acceleration, and price. Omitting the parameter still returns a ranked list using the default ordering. The response includes the resolved type string, a total count, and the full vehicles array in ranked order.Does the API cover EVs outside Europe?+
Can I filter `list_vehicles` by spec — for example, only vehicles with a range above 400 km?+
list_vehicles endpoint returns all vehicles without server-side spec filtering. Filtering by spec thresholds such as range or battery size is not currently supported. You can fork this API on Parse and revise it to add a filtered endpoint that accepts spec parameters.