ev-database.org 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.
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'
Retrieve a list of all electric vehicles with summary data including name, ID, slug, specs, and pricing across countries. Returns all vehicles in the database.
No input parameters required.
{
"type": "object",
"fields": {
"total": "integer total count of vehicles",
"vehicles": "array of vehicle summary objects with id, slug, name, url, specs and prices"
},
"sample": {
"data": {
"total": 1301,
"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": "445 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": "135 Wh/km",
"fastcharge": "110 kW",
"price/range": "€89 /km",
"1_stop_range": "523 km"
}
]
},
"status": "success"
}
}About the ev-database.org 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.
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.
- 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 | 250 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.