/cargurus/listings/search
Search CarGurus car listings by make (one or more, required) and optionally model (by name, within a single make) with the full filter set: inventory type (used/new/certified), location and radius, price range, mileage range, model year range, body style, fuel type, transmission, drivetrain, engine, exterior and interior color, number of seats, deal rating, vehicle history (clean title, single owner, no accidents, …), minimum NHTSA safety rating, seller type, minimum dealer rating, specific dealers, maximum days on market, minimum fuel economy and toggles for photos, price drops, financing, dealer-fee-inclusive pricing and hiding salvage or fleet vehicles. Sort by best match, best deal, price, mileage, distance, model year or listing age. Returns listing cards with price, IMV, deal rating, vehicle summary and seller.
Price: 1 credit
💡 AI Hint: Search CarGurus car listings. makes is required (at least one). models (by name, e.g. [‘RAV4’]) is optional and requires exactly one make. Filter by stock_type, zip+distance, price_min/price_max, mileage_min/mileage_max, year_min/year_max, body_types, fuel_types, transmissions, drivetrains, engines, exterior/interior colors, seats, deal_ratings, vehicle_history, nhtsa_safety_min, seller_types, dealer_rating_min, seller_ids, days_on_market_max, mpg_min and boolean toggles. Sort by best_match/best_deal/price/mileage/distance/year/listing age. count is required.
Authorizations
API token from the dashboard
Headers
Body
Vehicle makes to search
1acura, alfa_romeo, am_general, amc, aston_martin, auburn, audi, austin, austin_healey, bentley, bmw, bugatti, buick, cadillac, caterham, chevrolet, chrysler, citroen, daewoo, daihatsu, datsun, de_tomaso, delorean, desoto, dodge, durant, eagle, edsel, excalibur, ferrari, fiat, fisker, ford, freightliner, genesis, geo, ghia, gmc, graham, honda, hudson, hummer, hyundai, ineos, infiniti, intermeccanica, international_harvester, isuzu, jaguar, jeep, jensen, kaiser, karma, kia, koenigsegg, lada, lamborghini, lancia, land_rover, lexus, lincoln, lotus, lucid, maserati, maybach, mazda, mclaren, mercedes_benz, mercury, mg, mini, mitsubishi, mobility_ventures, morgan, morris, nash, nissan, oldsmobile, overland, packard, pagani, paige, panoz, peerless, peugeot, pininfarina, plymouth, polestar, pontiac, porsche, qvale, ram, renault, rivian, rolls_royce, rover, saab, saturn, scion, shelby, smart, ssc, studebaker, subaru, sunbeam, suzuki, tesla, toyota, triumph, vinfast, volkswagen, volvo, vpg, white, willys Max number of results to return
x >= 1Max scrapping execution timeout (in seconds)
20 <= x <= 1500Model names to restrict to (e.g. 'RAV4', 'Camry'); requires exactly one make
Inventory type
used, new, certified, third_party_certified Postal code to search around (best-effort)
3Search radius in miles around the location
1 <= x <= 50000Minimum price (USD)
x >= 0Maximum price (USD)
x >= 0Minimum mileage (miles)
x >= 0Maximum mileage (miles)
x >= 0Minimum model year
x >= 1900Maximum model year
x >= 1900Body styles to include
coupe, convertible, hatchback, minivan, pickup_truck, sedan, suv, van, wagon Fuel types to include
diesel, electric, gasoline, hybrid, cng, flex_fuel, biodiesel, propane, fuel_cell Transmission types to include
AUTOMATIC, MANUAL Drivetrain types to include
FOUR_WHEEL_DRIVE, FOUR_BY_TWO, REAR_WHEEL_DRIVE, ALL_WHEEL_DRIVE, FRONT_WHEEL_DRIVE Engine configurations to include
I4, I5, I6, V6, V8, V12 Exterior colors to include
BLACK, WHITE, GRAY, SILVER, BLUE, RED, GREEN, BROWN, GOLD, ORANGE, YELLOW, PURPLE, TEAL, PINK, UNKNOWN Interior colors to include
BLACK, WHITE, GRAY, SILVER, BLUE, RED, GREEN, BROWN, GOLD, ORANGE, YELLOW, PURPLE, TEAL, PINK, UNKNOWN Number of seats
TWO, FOUR, FIVE, SIX, SEVEN, AT_LEAST_EIGHT Deal ratings to include
great_deal, good_deal, fair_deal, high_price, overpriced, no_price_analysis, uncertain Vehicle history requirements
CLEAN_TITLE, SINGLE_OWNER, NON_FLEET, LEMON_FREE, NO_THEFT_HISTORY, UNDAMAGED_FRAME, NON_SALVAGE Minimum NHTSA overall safety rating
3, 4, 5 Seller types to include
FRANCHISE_DEALER, PAYING_DEALER Minimum average dealer rating
ONE_STAR_AND_MORE, TWO_STAR_AND_MORE, THREE_STAR_AND_MORE, FOUR_STAR_AND_MORE, FIVE_STAR Restrict to specific dealer ids
Maximum days on market
x >= 0Minimum combined fuel economy (MPG)
x >= 0Only listings that have photos
Only listings with a recent price drop
Only listings with online financing
Only listings that include dealer fees in the price
Hide listings with a salvage history
Hide fleet (rental or corporate) vehicles
Sort order
best_match, best_deal, price_low, price_high, mileage_low, mileage_high, distance, year_new, year_old, newest_listed, oldest_listed Response
Successful Response