Electric Vehicle API

The Electric Vehicle API provides dozens of detailed datapoints on electric vehicles including range, battery capacity, charging time and performance metrics.

Available endpoints:

For non-EV-specific data on all cars, see the Cars API.

/v1/electricvehicle GET

https://api.api-ninjas.com/v1/electricvehicle

Get electric vehicle data from given parameters. Returns a list of electric vehicles that satisfy the parameters.


Parameters

At least one parameter (other than limit and offset) is required.

  • make  optional

    Vehicle manufacturer (e.g. tesla or nissan).

  • model  optional

    Vehicle model (e.g. model3 or leaf).

  • min_year  optional

    Minimum vehicle model year (e.g. 2020).

  • max_year  optional

    Maximum vehicle model year (e.g. 2023).

  • min_range  optional

    Minimum range in kilometers (e.g. 250).

  • max_range  optional

    Maximum range in kilometers (e.g. 400).

  • limit  optional Premium Only

    How many results to return. Must be between 1 and 10. Default is 1.

  • offset  optional Premium Only

    Number of results to skip. Used for pagination. Default is 0.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Sample Request Live Demo!

model
https://api.api-ninjas.com/v1/electricvehicle?model=Model 3

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 [ { "make": "Tesla", "model": "Model 3", "year_start": "2023", "battery_capacity": "60.0 kWh", "battery_type": "Lithium-ion", "battery_number_of_cells": "106", "battery_architecture": "400 V", "battery_useable_capacity": "57.5 kWh", "battery_cathode_material": "LFP", "battery_pack_configuration": "106s1p", "battery_voltage": "340 V", "battery_form_factor": "Prismatic", "battery_name": "CATL LFP60", "charge_port": "CCS", "charge_port_location": "Left Side - Rear", "charge_power": "11 kW AC", "charge_speed": "730 km/h", "charge_power_max": "170 kW DC", "charge_power_10p_80p": "108 kW DC", "autocharge_supported": "Yes", "plug_charge_supported": "No", "supported_charging_protocol": "-", "preconditioning_possible": "Yes", "acceleration_0_100_kmh": "6.1 sec", "top_speed": "201 km/h", "electric_range": "420 km", "total_power": "208 kW (283 PS)", "total_torque": "420 Nm", "drive": "Rear", "vehicle_consumption": "112 Wh/km", "co2_emissions": "0 g/km", "vehicle_fuel_equivalent": "1.3 l/100km", "rated_consumption": "No Data", "rated_fuel_equivalent": "No Data", "energy_consumption_city_cold_weather": "149 Wh/km", "energy_consumption_highway_cold_weather": "189 Wh/km", "energy_consumption_combined_cold_weather": "167 Wh/km", "energy_consumption_city_mild_weather": "93 Wh/km", "energy_consumption_highway_mild_weather": "142 Wh/km", "energy_consumption_combined_mild_weather": "116 Wh/km", "length": "4720 mm", "width": "1849 mm", "width_with_mirrors": "2089 mm", "height": "1441 mm", "wheelbase": "2875 mm", "gross_vehicle_weight": "2200 kg", "max_payload": "439 kg", "cargo_volume": "594 L", "cargo_volume_frunk": "88 L", "seats": "5 people", "turning_circle": "No Data", "platform": "TESLA 3/Y", "car_body": "Sedan", "segment": "D - Large" } ]

Code Examples

1 2 3 4 5 6 7 8 9 import requests model = 'model3' api_url = 'https://api.api-ninjas.com/v1/electricvehicle?model={}'.format(model) response = requests.get(api_url, headers={'X-Api-Key': 'YOUR_API_KEY'}) if response.status_code == requests.codes.ok: print(response.text) else: print("Error:", response.status_code, response.text)

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.

Annual premium subscriptions only

/v1/electricvehiclemakes GET

https://api.api-ninjas.com/v1/electricvehiclemakes

Returns a list of all electric vehicle makes (manufacturers).


Parameters

  • year  optional

    Filter manufacturers by year (e.g. 2023).

Headers

  • X-Api-Key  required

    API Key associated with your account.

Sample Request

https://api.api-ninjas.com/v1/electricvehiclemakes

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
1 2 3 4 5 6 7 [ ... "Tesla", "Toyota", "Vinfast", ... ]

Annual premium subscriptions only

/v1/electricvehiclemodels GET

https://api.api-ninjas.com/v1/electricvehiclemodels

Returns a list of all electric vehicle models for a given make (manufacturer).


Parameters

  • make  required

    Vehicle manufacturer (e.g. tesla).

  • year  optional

    Vehicle model year (e.g. 2023).

Headers

  • X-Api-Key  required

    API Key associated with your account.

Sample Request

make
https://api.api-ninjas.com/v1/electricvehiclemodels?make=Tesla

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
1 2 3 4 5 6 [ "Model 3", "Model 3 Long Range Dual Motor", "Model 3 Long Range Performance", ... ]