A trim is one specific version of a model in a given year, such as the 2024 Honda Civic Sport sedan. Trims hold the prices and full specs.
Search trims
Searches all trims. Every filter is optional and filters combine with AND.
Query parameters
| Name | Type | Match | Description |
|---|
q | string | contains | Free text. Matched against make, model, trim and description. Each word must match, up to 5 words |
make | string | exact | Make name, for example Toyota |
model | string | exact | Model name, for example RAV4 |
year | integer | exact | Model year |
year_min | integer | ≥ | Earliest model year |
year_max | integer | ≤ | Latest model year |
body_type | string | exact | For example SUV, Sedan, Truck (Crew Cab) |
engine_type | string | exact | For example gas, electric, hybrid, plug-in hybrid |
fuel_type | string | contains | For example premium, diesel |
drive_type | string | contains | For example all wheel, four wheel, rear |
country | string | exact | Country of origin, for example Japan |
min_price | number | ≥ | Minimum base MSRP in USD |
max_price | number | ≤ | Maximum base MSRP in USD |
min_hp | number | ≥ | Minimum horsepower |
max_hp | number | ≤ | Maximum horsepower |
min_mpg | number | ≥ | Minimum EPA combined MPG |
min_range | number | ≥ | Minimum EV range in miles |
min_seats | integer | ≥ | Minimum seats |
sort | string | | Sort field, see Sorting. Default: make, model, newest year, price |
page | integer | | Page number, default 1 |
limit | integer | | Results per page, 1 to 100, default 20 |
Exact matches ignore upper and lower case. Use GET /api/filters to get the valid values for body_type, engine_type, fuel_type, drive_type and country.
Example
Electric SUVs under $50,000, cheapest first:
curl "http://localhost:3000/api/trims?body_type=SUV&engine_type=electric&max_price=50000&sort=price&limit=2"
{
"data": [
{
"id": 401985516,
"make": "Hyundai",
"model": "Kona Electric",
"year": 2024,
"trim": "SE",
"trim_description": "SE 4dr SUV (electric DD)",
"body_type": "SUV",
"base_msrp": 32675,
"horsepower_hp": 133,
"engine_type": "electric",
"fuel_type": "electric",
"drive_type": "front wheel drive",
"transmission": "1-speed direct drive",
"total_seating": 5,
"epa_combined_mpg": null,
"epa_combined_mpge": null,
"epa_electricity_range_mi": 197,
"image_urls": [
"https://media.ed.edmunds-media.com/hyundai/kona-electric/2024/oem/2024_hyundai_kona-ele...",
"https://media.ed.edmunds-media.com/hyundai/kona-electric/2024/oem/2024_hyundai_kona-ele..."
]
},
{
"id": 401890721,
"make": "Mazda",
"model": "MX-30",
"year": 2022,
"trim": "(base)",
"trim_description": "4dr SUV (electric DD)",
"body_type": "SUV",
"base_msrp": 33470,
"horsepower_hp": 143,
"engine_type": "electric",
"fuel_type": "electric",
"drive_type": "front wheel drive",
"transmission": "1-speed direct drive",
"total_seating": 5,
"epa_combined_mpg": null,
"epa_combined_mpge": 92,
"epa_electricity_range_mi": 100,
"image_urls": [
"https://media.ed.edmunds-media.com/mazda/mx-30/2022/oem/2022_mazda_mx-30_4dr-suv_base_f...",
"https://media.ed.edmunds-media.com/mazda/mx-30/2022/evox/2022_mazda_mx-30_4dr-suv_premi..."
]
}
],
"pagination": {
"page": 1,
"limit": 2,
"total": 77,
"pages": 39
}
}
Long text and arrays are shortened in these examples.
More examples
| Goal | Request |
|---|
| Free-text search | /api/trims?q=civic sport&year=2024 |
| Teslas by longest range | /api/trims?make=Tesla&sort=-range |
| Most powerful cars | /api/trims?sort=-horsepower&limit=10 |
| 40+ MPG | /api/trims?min_mpg=40&sort=-mpg |
| 7+ seat AWD | /api/trims?min_seats=7&drive_type=all wheel&sort=price |
| Best towing | /api/trims?q=truck&sort=-towing |
| German-made 2024 cars | /api/trims?country=Germany&year=2024 |
| Under $30k, 2023 or newer | /api/trims?max_price=30000&year_min=2023&sort=price |
Trim summary fields
Search results and model trim lists use this short form. Use Get a trim for everything else.
| Field | Type | Description |
|---|
id | integer | Trim ID |
make | string | Make name |
model | string | Model name |
year | integer | Model year |
trim | string | Trim name, (base) for the base trim |
trim_description | string | Body, engine and transmission summary |
body_type | string | Body style |
base_msrp | integer | Base price in USD |
horsepower_hp | integer | Horsepower |
engine_type | string | gas, electric, hybrid and so on |
fuel_type | string | Fuel needed |
drive_type | string | Front, rear, all or four wheel drive |
transmission | string | Transmission |
total_seating | integer | Seats |
epa_combined_mpg | integer | EPA combined MPG, null for EVs |
epa_combined_mpge | integer | EPA combined MPGe, for EVs and plug-ins |
epa_electricity_range_mi | integer | EV range in miles |
image_urls | string[] | Photo URLs |
Get a trim
Returns every spec for one trim, grouped into sections.
Path parameters
| Name | Type | Description |
|---|
id | integer | Trim ID |
Example
curl http://localhost:3000/api/trims/401901022
{
"id": 401901022,
"make": "Acura",
"model": "ILX",
"year": 2022,
"trim": "(base)",
"trim_description": "4dr Sedan w/Premium Package (2.4L 4cyl 8AM)",
"make_id": 1,
"model_id": 1,
"image_urls": [
"https://media.ed.edmunds-media.com/acura/ilx/2019/oem/2019_acura_ilx_sedan_technology-a...",
"https://media.ed.edmunds-media.com/acura/ilx/2021/evox/2021_acura_ilx_sedan_base_pr_evo..."
],
"source_url": "https://www.edmunds.com/acura/ilx/2022/review/",
"pricing": {
"base_msrp": 29300,
"base_invoice": 28209,
"used_price_range": null
},
"body": {
"body_type": "Sedan",
"doors": 4,
"total_seating": 5,
"car_classification": "Compact car"
},
"dimensions": {
"length_in": 182.2,
"width_in": 70.6,
"height_in": 55.6,
"wheelbase_in": 105.1,
"ground_clearance_in": 5.3,
"turning_circle_ft": 36.8,
"angle_of_approach_degrees": null,
"angle_of_departure_degrees": null,
"epa_interior_volume_cu_ft": 101.7,
"cargo_capacity_cu_ft": 12.4,
"maximum_cargo_capacity_cu_ft": null
},
"weight_and_capacity": {
"curb_weight_lbs": 3122,
"gross_weight_lbs": null,
"maximum_payload_lbs": null,
"maximum_towing_capacity_lbs": null
},
"engine": {
"engine_type": "gas",
"cylinders": "I4",
"engine_size_l": 2.4,
"horsepower_hp": 201,
"horsepower_rpm": 6800,
"torque_ft_lbs": 180,
"torque_rpm": 3600,
"valves": 16,
"valve_timing": "Variable",
"cam_type": "Double overhead cam (DOHC)",
"drive_type": "front wheel drive",
"transmission": "8-speed automated manual"
},
"fuel_economy": {
"fuel_type": "premium unleaded (recommended)",
"fuel_tank_capacity_gal": 13.2,
"epa_combined_mpg": 28,
"epa_city_highway_mpg": "24/34 MPG",
"range_in_miles_city_hwy": "316.8/448.8 mi.",
"epa_combined_mpge": null,
"epa_city_highway_mpge": null,
"epa_electricity_range_mi": null,
"epa_kwh_100_mi": null,
"epa_time_to_charge_battery_at_240v_hr": null,
"battery_capacity_kwh": null
},
"interior": {
"front_head_room_in": 38,
"front_hip_room_in": 50.3,
"front_leg_room_in": 42.3,
"front_shoulder_room_in": 55.6,
"rear_head_room_in": 35.9,
"rear_hip_room_in": 51.7,
"rear_leg_room_in": 34,
"rear_shoulder_room_in": 53.6
},
"warranty": {
"basic": "4 yr./ 50000 mi.",
"drivetrain": "6 yr./ 70000 mi.",
"roadside_assistance": "4 yr./ 50000 mi.",
"rust": "5 yr./ unlimited mi."
},
"origin": {
"country_of_origin": "Japan",
"domestic_imported": "Imported",
"platform_code_generation_number": "-"
},
"review": {
"summary": "The 2022 Acura ILX is a small luxury sedan and it's currently the smallest vehicle th...",
"pros": [
"Plenty of features for the money",
"Good fuel economy for a small sedan"
],
"cons": [
"Plasticky interior trim",
"Overly stiff ride"
],
"whats_new": [
"No significant changes for 2022",
"Part of the first ILX generation introduced for 2013"
],
"expert_rating": {
"overall": "6.6/10",
"performance": "6.0/10",
"comfort": "6.5/10",
"interior": "6.5/10",
"technology": "6.0/10",
"storage": "6.5/10",
"fuel_economy": "8.5/10",
"value": "8.0/10",
"wildcard": "6.5/10"
}
},
"colors": {
"exterior": [
{
"name": "Lunar Silver Metallic",
"rgb": [
141,
145
],
"hex": "#8d919a"
},
{
"name": "Majestic Black Pearl",
"rgb": [
30,
30
],
"hex": "#1e1e1e"
}
],
"interior": [
{
"name": "Ebony, leather",
"rgb": [
25,
25
],
"hex": "#191919"
},
{
"name": "Espresso, leather",
"rgb": [
155,
107
],
"hex": "#9b6b57"
}
]
},
"date_added": "2021-08-08"
}
Long text and arrays are shortened in these examples.
Sections
| Section | Contents |
|---|
| top level | id, make, model, year, trim, trim_description, make_id, model_id, image_urls, source_url, date_added |
pricing | Base MSRP, invoice price, used price range |
body | Body type, doors, seats, size class |
dimensions | Exterior size, ground clearance, off-road angles, cargo space |
weight_and_capacity | Curb and gross weight, payload, towing |
engine | Engine type, cylinders, size, power, torque, drive type, transmission |
fuel_economy | Fuel type, tank size, MPG, MPGe, EV range, charge time, battery size |
interior | Head, hip, leg and shoulder room, front and rear |
warranty | Basic, drivetrain, roadside assistance and rust coverage |
origin | Country of origin, domestic or imported, platform code |
review | Review text, pros, cons, what's new, expert ratings |
colors | Same as Get trim colors |
See the data dictionary for every field.
Returns 404 if the trim does not exist.
Get trim colors
GET /api/trims/{id}/colors
Returns the trim's exterior and interior color options, sorted by name.
Example
curl http://localhost:3000/api/trims/401901022/colors
{
"exterior": [
{
"name": "Lunar Silver Metallic",
"rgb": [
141,
145
],
"hex": "#8d919a"
},
{
"name": "Majestic Black Pearl",
"rgb": [
30,
30
],
"hex": "#1e1e1e"
}
],
"interior": [
{
"name": "Ebony, leather",
"rgb": [
25,
25
],
"hex": "#191919"
},
{
"name": "Espresso, leather",
"rgb": [
155,
107
],
"hex": "#9b6b57"
}
]
}
Fields
| Field | Type | Description |
|---|
name | string | Color name as used by the maker |
rgb | integer[3] | Red, green and blue values, 0 to 255. null if unknown |
hex | string | Hex color code, for example #8d919a. null if unknown |
The RGB values are approximate and meant for showing a color swatch.
Returns 404 if the trim does not exist.
Last modified on
powered by apitogo