Skip to main content
POST
/cars/listings/search

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
count
integer
required
Required range: x >= 1
timeout
integer
default:300
Required range: 20 <= x <= 1500
stock_type
enum<string> | null
Available options:
new_cpo,
new,
used,
cpo
makes
enum<string>[]
Available options:
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
models
string[]
trims
string[]
zip
string | null
Minimum string length: 3
radius_miles
integer | null
Required range: x >= 1
price_min
integer | null
Required range: x >= 0
price_max
integer | null
Required range: x >= 0
year_min
integer | null
Required range: x >= 1900
year_max
integer | null
Required range: x >= 1900
mileage_max
integer | null
Required range: x >= 0
body_styles
enum<string>[]
Available options:
suv,
truck,
sedan,
hatchback,
coupe,
passenger_van,
cargo_van,
convertible,
minivan,
wagon
sizes
enum<string>[]
Available options:
full_size,
mid_size,
compact,
subcompact
cab_types
enum<string>[]
Available options:
crew_cab,
extended_cab,
regular_cab
door_counts
enum<string>[]
Available options:
2,
3,
4,
5,
6,
8,
0
cylinder_counts
enum<string>[]
Available options:
3,
4,
5,
6,
8,
10,
12,
0
exterior_colors
enum<string>[]
Available options:
beige,
black,
blue,
brown,
gold,
gray,
green,
orange,
pink,
purple,
red,
silver,
white,
yellow
interior_colors
enum<string>[]
Available options:
beige,
black,
blue,
brown,
gold,
gray,
green,
orange,
pink,
purple,
red,
silver,
white,
yellow
fuel_types
enum<string>[]
Available options:
compressed_natural_gas,
diesel,
e85_flex_fuel,
electric,
gasoline,
hybrid,
hydrogen_fuel_cell,
plug_in_hybrid
transmissions
enum<string>[]
Available options:
automanual,
automatic,
cvt,
manual,
unknown
drivetrains
enum<string>[]
Available options:
all_wheel_drive,
four_wheel_drive,
front_wheel_drive,
rear_wheel_drive,
unknown
deal_ratings
enum<string>[]
Available options:
great,
good,
fair
seller_types
enum<string>[]
Available options:
dealership,
online_seller,
private_seller
conditions
enum<string>[]
Available options:
has_report
cpo_programs
enum<string>[]
Available options:
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
enum<string>[]
Available options:
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
enum<string>[]
Available options:
android_auto,
apple_carplay,
bluetooth,
cd_player,
dvd_player,
homelink,
premium_sound_system,
rear_seat_entertaiment,
satellite_radio,
usb_port,
wifi_hotspot
exterior_features
enum<string>[]
Available options:
alloy_wheels,
roof_rack,
sunroof_moonroof,
tow_hitch,
tow_hooks
safety_features
enum<string>[]
Available options:
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
enum<string>[]
Available options:
leather_seats,
memory_seat,
third_row_seating
lifestyles
enum<string>[]
Available options:
enthusiast,
family_friendly,
luxury,
off_road,
sporty
awards
enum<string>[]
Available options:
ami,
best_of
vehicle_history
enum<string>[]
Available options:
no_accidents,
clean_title,
one_owner,
personal_use
ev_range_min
integer | null
Required range: x >= 0
charge_time_max
enum<string> | null
Available options:
0,
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19
keyword
string | null
only_with_photos
boolean
default:false
include_shippable
boolean
default:true
sort
enum<string>
default:best_match
Available options:
best_match,
price_low,
price_high,
mileage_low,
mileage_high,
distance,
best_deal,
year_new,
year_old,
newest_listed,
oldest_listed

Response

Successful Response

id
string
required
@type
string
default:CarsListing
url
string | null
vin
string | null
make
string | null
model
string | null
year
integer | null
trim
string | null
body_style
string | null
stock_type
string | null
is_cpo
boolean
default:false
is_verified
boolean
default:false
price
number | null
msrp
number | null
mileage
number | null
drivetrain
string | null
exterior_color
string | null
fuel_type
string | null
seller_id
string | null
seller_zip
string | null
financing_type
string | null
image
string | null
images
string[]
image_count
integer | null
rank_enthusiast
number | null
rank_family_friendly
number | null
rank_luxury
number | null
rank_off_road
number | null
rank_sporty
number | null