/cars/listings/search
Search Cars.com vehicle listings with the full filter set: stock type (new/used/CPO), make, model and trim, postal code and radius, price range, model-year range, maximum mileage, body style, vehicle size, cab type, door and cylinder counts, exterior and interior color, fuel type, transmission, drivetrain, deal rating, seller type, dealer-verified condition, CPO program, convenience/entertainment/exterior/safety/seating features, lifestyle, awards, vehicle history, EV range and charge time, and free-text keyword. Sort by best match, price, mileage, year, distance, best deal or recency. Returns listing cards with vehicle summary, price, mileage, photos and seller.
Price: 5 credits per 50 results
💡 AI Hint: Search Cars.com listings. makes are enum slugs (e.g. ‘honda’); models are make-model slugs (e.g. ‘honda-accord’) and need makes set too. Filter by stock_type, zip+radius_miles, price_min/price_max, year_min/year_max, mileage_max, body_styles, fuel_types, transmissions, drivetrains, exterior/interior colors, deal_ratings, seller_types, cpo_programs, convenience/entertainment/exterior/safety/seating features, lifestyles, awards, vehicle_history, ev_range_min, charge_time_max and keyword. count is required.
Authorizations
API token from the dashboard
Headers
Body
Max number of results to return
x >= 1Max scrapping execution timeout (in seconds)
20 <= x <= 1500New / Used / CPO stock type
new_cpo, new, used, cpo Vehicle makes
ac, acura, alfa_romeo, am_general, american_motors, aston_martin, auburn, audi, austin_healey, avanti_motors, bentley, bmw, bricklin, bugatti, buick, cadillac, chevrolet, chrysler, cord, daewoo, datsun, delorean, desoto, detomaso, dodge, edsel, excalibur, ferrari, fiat, fisker, ford, genesis, geo, gmc, honda, hudson, hummer, hyundai, ineos, infiniti, international, isuzu, jaguar, jeep, jensen, kaiser, karma, kia, koenigsegg, lamborghini, land_rover, lexus, lincoln, lotus, lucid, maserati, maybach, mazda, mclaren, mercedes_benz, mercury, mg, mini, mitsubishi, morgan, nash, nissan, oldsmobile, packard, pagani, panoz, plymouth, polestar, pontiac, porsche, qvale, ram, rivian, rolls_royce, saab, saleen, saturn, scion, smart, studebaker, subaru, sunbeam, suzuki, tesla, toyota, triumph, vinfast, volkswagen, volvo, willys Model slugs in make-model form (e.g. 'honda-accord'); set makes too
Trim slugs (requires makes/models to be set)
Postal code to search around
3Search radius around the postal code, in miles
x >= 1Minimum list price (USD)
x >= 0Maximum list price (USD)
x >= 0Minimum model year
x >= 1900Maximum model year
x >= 1900Maximum mileage (miles)
x >= 0Body styles
suv, truck, sedan, hatchback, coupe, passenger_van, cargo_van, convertible, minivan, wagon Vehicle sizes
full_size, mid_size, compact, subcompact Truck cab types
crew_cab, extended_cab, regular_cab Door counts
2, 3, 4, 5, 6, 8, 0 Engine cylinder counts
3, 4, 5, 6, 8, 10, 12, 0 Exterior colors
beige, black, blue, brown, gold, gray, green, orange, pink, purple, red, silver, white, yellow Interior colors
beige, black, blue, brown, gold, gray, green, orange, pink, purple, red, silver, white, yellow Fuel types
compressed_natural_gas, diesel, e85_flex_fuel, electric, gasoline, hybrid, hydrogen_fuel_cell, plug_in_hybrid Transmission types
automanual, automatic, cvt, manual, unknown Drivetrain types
all_wheel_drive, four_wheel_drive, front_wheel_drive, rear_wheel_drive, unknown Deal ratings
great, good, fair Seller types
dealership, online_seller, private_seller Dealer-verified condition filters
has_report Manufacturer CPO programs
acura_precision_certified, acura_precision_certified_ev, aston_martin, bentley, bmw, cadillac, carbravo, carbravo_bravobudget, ferrari, ford_blue, ford_blue_advantage_ev, ford_gold, genesis, honda_true_certified, hondatrue_certified_ev, hyundai, infiniti, infiniti_certified_pre_owned_select, kia, kia_lite, lexus, lincoln, mazda, mercedes_benz, mitsubishi, nissan, nissan_certified_select, polestar, porsche, rolls_royce, subaru, toyota, volkswagen, volvo Convenience features
adaptive_cruise_control, automatic_parking, autopilot, cooled_seats, heated_seats, heated_steering_wheel, keyless_entry, keyless_start, navigation_system, power-folding_mirrors, power_liftgate, remote_start, wheelchair_accessible Entertainment features
android_auto, apple_carplay, bluetooth, cd_player, dvd_player, homelink, premium_sound_system, rear_seat_entertaiment, satellite_radio, usb_port, wifi_hotspot Exterior features
alloy_wheels, roof_rack, sunroof_moonroof, tow_hitch, tow_hooks Safety features
automatic_emergency_braking, backup_camera, blind_spot_monitor, brake_assist, led_headlights, lane_departure_warning, rain-sensing-wipers, rear_cross_traffic_alert, stability_control Seating features
leather_seats, memory_seat, third_row_seating Lifestyle categories
enthusiast, family_friendly, luxury, off_road, sporty Award badges
ami, best_of Vehicle history requirements
no_accidents, clean_title, one_owner, personal_use Minimum EV total range (miles)
x >= 0Maximum EV charge time on 240V (hours)
0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19 Free-text keyword (matches VIN, stock number, text)
Only listings that have photos
Include listings shippable from outside the area
Sort order
best_match, price_low, price_high, mileage_low, mileage_high, distance, best_deal, year_new, year_old, newest_listed, oldest_listed Response
Successful Response