Find Vehicles For Sale
find_vehicles_for_saleFull Description
Search for vehicles based on various criteria. Returns a dictionary with search results. Takes input as JSON object with the following fields:
- zip_code (int): US ZIP code for search center
- radius (int): Search radius in miles. Options: 10, 25, 50, 75, 100, 150, 200, 250, 500, 3000
- vehicle_condition (str): Filter by condition. Options: USED, NEW, ANY
- make (str, optional): Vehicle make (e.g., Ford, Toyota, Honda)
- model (str, optional): Vehicle model (e.g., Civic, Camry, F-150, Elantra N, Golf, GR Supra)
- year_min (int, optional): Minimum year
- year_max (int, optional): Maximum year
- price_min (int, optional): Minimum price in dollars
- price_max (int, optional): Maximum price in dollars
- mileage_min (int, optional): Minimum mileage
- mileage_max (int, optional): Maximum mileage
- mpg_combined_min (int, optional): Minimum combined MPG
- mpg_combined_max (int, optional): Maximum combined MPG
- bodytypes (list[str], optional): Body types (comma-separated: SUV, Pickup, Sedan, Minivan, Coupe, Wagon, Convertible, Hatchback, Chassis, Van)
- bed_type (str, optional): Bed type for trucks (comma-separated). Examples: Short Bed, Long Bed, Regular Bed, Unspecified
- cab_type (str, optional): Cab type for trucks (comma-separated). Options: Crew Cab, Extended Cab, Regular Cab, Unspecified
- no_accidents (bool, optional): Filter to vehicles with no accidents
- one_owner (bool, optional): Filter to CARFAX 1-Owner vehicles
- personal_use (bool, optional): Filter to personal use vehicles
- service_records (bool, optional): Filter to vehicles that include service records
- value_badges (str, optional): Filter by CARFAX Value Badges. Options: GREAT, GOOD, FAIR, NONE
- colors (str, optional): Exterior colors (comma-separated). Examples: Black, White, Red, Blue, Gray, Silver, Green, Yellow, Brown, Beige, Gold, Orange, Purple
- interior_colors (str, optional): Interior colors (comma-separated). Examples: Black, Gray, Beige, Brown, White, Red, Blue, Tan, Green, Yellow
- transmissions (str, optional): Comma-separated transmission types (Automatic, Manual, Unspecified) For multiple, separate with commas, ex: 'Automatic,Manual'
- drive_types (str, optional): Drive types (comma-separated). Examples: FWD, RWD, AWD, 4WD
- engines (str, optional): Engine types (comma-separated). Examples: 4 Cyl, 6 Cyl, 8 Cyl, Electric
- fuel_types (str, optional): Fuel types (comma-separated) Electric, Gasoline, Diesel, Hybrid, Flexible-Fuel
- trims (str, optional): Vehicle trims (comma-separated)
- popular_options (str, optional): Popular options (comma-separated). Examples: Adaptive Cruise Control, Alloy Wheels, Android Auto, Anti-Theft System, Apple Carplay, Automatic Headlights, Blind Spot Monitor, Braking Assist, Bucket Seats, Cross Traffic Alert, Dual-Zone Climate Control, Fog Lights, HD Radio, Handsfree/Bluetooth Integration, Heated Mirrors, Heated Seats, Heated Steering Wheel, High-Beam Assist, Keyless Entry, Keyless Ignition, LED Lights, Lane Departure Warning, Leather Seats, Navigation System, Parking Sensors, Power Liftgate, Premium Sound System, Privacy Glass, Rain-Sensing Wipers, Rear-View Camera, Remote Start, Roof Rails, Satellite Radio, Seat Memory, Spoiler, Stability Control, Steering Wheel Controls, Sun/Moonroof, Tire Pressure Monitoring System, Traction Control.
- certified (bool, optional): Filter for certified pre-owned vehicles
- sort (str, optional): Sort order for vehicle results. Options: BEST, PRICE_DESC, PRICE_ASC, MILEAGE_DESC, MILEAGE_ASC, YEAR_DESC, YEAR_ASC, LOCATION_NEAREST, LOCATION_FURTHEST, INORDER, LISTING_DATE_ASC, LISTING_DATE_DESC
Returns: dict: A dictionary containing the search results.
Parameters (1 required, 30 optional)
zip_codestring5-digit US ZIP code
bed_typestringBed type for trucks (comma-separated). Examples: Short Bed, Long Bed, Regular Bed, Unspecified
nullbodytypesstringBody types (comma-separated: SUV, Pickup, Sedan, Minivan, Coupe, Wagon, Convertible, Hatchback, Chassis, Van)
nullcab_typestringCab type for trucks (comma-separated). Options: Crew Cab, Extended Cab, Regular Cab, Unspecified
nullcertifiedbooleanFilter for certified pre-owned vehicles
nullcolorsstringExterior colors (comma-separated). Examples: Black, White, Red, Blue, Gray, Silver, Green, Yellow, Brown, Beige, Gold, Orange, Purple
nulldrive_typesstringDrive types (comma-separated). Examples: FWD, RWD, AWD, 4WD
nullenginesstringEngine types (comma-separated). Examples: 4 Cyl, 6 Cyl, 8 Cyl, Electric
nullfuel_typesstringFuel types (comma-separated) Electric, Gasoline, Diesel, Hybrid, Flexible-Fuel
nullinterior_colorsstringInterior colors (comma-separated). Examples: Black, Gray, Beige, Brown, White, Red, Blue, Tan, Green, Yellow
nullmakestringVehicle make (e.g., Ford, Toyota, Honda)
nullmileage_maxintegerMaximum mileage
nullmileage_minintegerMinimum mileage
nullmodelstringVehicle model (e.g., Civic, Camry, F-150)
nullmpg_combined_maxintegerMaximum combined MPG
nullmpg_combined_minintegerMinimum combined MPG
nullno_accidentsbooleanOnly show vehicles with no accidents
nullone_ownerbooleanOnly show vehicles with CARFAX 1-Owner history
nullpersonal_usebooleanOnly show vehicles that were for personal use
nullpopular_optionsstringPopular options (comma-separated). Examples: Adaptive Cruise Control, Alloy Wheels, Android Auto, Anti-Theft System, Apple Carplay, Automatic Headlights, Blind Spot Monitor, Braking Assist, Bucket Seats, Cross Traffic Alert, Dual-Zone Climate Control, Fog Lights, HD Radio, Handsfree/Bluetooth Integration, Heated Mirrors, Heated Seats, Heated Steering Wheel, High-Beam Assist, Keyless Entry, Keyless Ignition, LED Lights, Lane Departure Warning, Leather Seats, Navigation System, Parking Sensors, Power Liftgate, Premium Sound System, Privacy Glass, Rain-Sensing Wipers, Rear-View Camera, Remote Start, Roof Rails, Satellite Radio, Seat Memory, Spoiler, Stability Control, Steering Wheel Controls, Sun/Moonroof, Tire Pressure Monitoring System, Traction Control.
nullprice_maxintegerMaximum price in dollars
nullprice_minintegerMinimum price in dollars
nullradiusintegerSearch radius in miles. Options: 10, 25, 50, 75, 100, 150, 200, 250, 500, 3000
50service_recordsbooleanOnly show vehicles that include service records
nullsortstringSort order for vehicle results. Options: BEST, PRICE_DESC, PRICE_ASC, MILEAGE_DESC, MILEAGE_ASC, YEAR_DESC, YEAR_ASC, LOCATION_NEAREST, LOCATION_FURTHEST, LISTING_DATE_ASC, LISTING_DATE_DESC
BESTPRICE_DESCPRICE_ASCMILEAGE_DESCMILEAGE_ASCYEAR_DESCYEAR_ASCLOCATION_NEARESTLOCATION_FURTHESTLISTING_DATE_ASCLISTING_DATE_DESCBESTtransmissionsstringComma-separated transmission types (Automatic, Manual, Unspecified) For multiple, separate with commas, ex: 'Automatic,Manual'
nulltrimsstringVehicle trims (comma-separated)
nullvalue_badgesstringFilter by CARFAX Value Badges. Options: GREAT, GOOD, FAIR, NONE
nullvehicle_conditionstringFilter by condition. Options: USED, NEW, ANY
USEDNEWANYUSEDyear_maxintegerMaximum year
nullyear_minintegerMinimum year
null