VIvinaudit
Market Data

Market Listings API

Search retail vehicle listings across the US and Canada with 20+ filters (dealer, location, radius, year/make/model/trim, vehicle attributes). Also accepts POST with the same parameters.

get/v1/listings

Request

Query parameters

format'json' | 'xml'
vinstring
Example:2T1BURHE3EC020936

Vehicle identification number.

vehicle_makestring
Example:Tesla
spec_vinstring

Reference VIN used to find listings with similar year/make/model.

spec_vin_match'model' | 'trim'
spec_idstring
Example:2021_tesla_model-3_long-range

Year/make/model/trim ID (supports year, year_make, year_make_model, year_make_model_trim, make, make_model, make_model_trim). Takes precedence over spec_vin.

listing_typestring
Example:Used

New, Used, Certified (default all three).

listing_price_minnumber
listing_price_maxnumber
postalstring
Example:30680
latitudenumber
longitudenumber
radiusinteger

Miles (USA) or kilometers (Canada). Default 25.

citystring

If set, region is required.

regionstring
Example:GA

2-letter state/province code.

country'usa' | 'canada'

usa (USD, miles) or canada (CAD, km).

seller_type'franchise' | 'independent' | 'private'

Default franchise,independent.

seller_idstring
Example:dealername_winder_ga
dealer_attributioninteger
spec_accuracyinteger
listing_statusstring

Comma-separated -- active, in-transit, dropped, all. Default active,in-transit.

history_daysinteger

Days to look back for dropped listings.

vehicle_type'sedan' | 'coupe' | 'truck' | 'suv' | 'hatchback' | 'van' | 'wagon' | 'convertible' | 'minivan'
vehicle_fuel_type'diesel' | 'electric' | 'flex' | 'gasoline' | 'hybrid' | 'hydrogen' | 'plug-in'
vehicle_engine_cylindersinteger
vehicle_transmission_type'automatic' | 'manual'
vehicle_drivetrain'rwd' | 'fwd' | 'awd' | '4wd'
vehicle_doorsinteger
page_sizeinteger
pageinteger

Response

Paged list of listings

totalinteger

Listings in this page

query_totalinteger

Total matching listings

pageinteger
page_sizeinteger
listingsobject[]

Changes

No recorded changes to this operation across all 1 revision of this API.