docs / api / market / listings

Market Listings API

The Market Listings API provides access to retail vehicle listings across the United States and Canada through GET or POST requests. Access requires an API-enabled account and a unique VinAudit API key to authenticate and authorize requests. With 20+ search parameters, the API lets you filter listings by dealer, region/postal code, radius, year, make, model, trim, and vehicle attributes such as color or vehicle type.

GET
https://marketlistings.vinaudit.com/v1/listings

Request Parameters

Parameter

key

required

Example

YOUR_API_KEY_HERE

Description

Your account API key

Parameter

format

optional

Example

json

Description

Output format. Options: json (default), xml

Parameter

vin

optional

Example

5YJ3E1EB2MF050615

Description

Search listings for a specific Vehicle Identification Number

Parameter

vehicle_make

optional

Example

Tesla

Description

Filter listings for a particular vehicle make within a specific area

Parameter

spec_vin

optional

Example

5YJ3E1EB2MF050615

Description

A reference VIN used to find listings with similar year, make, model

Parameter

spec_vin_match

optional

Example

model

Description

How to match listings similar to spec_vin. Options: model, trim.

Parameter

spec_id

optional

Example

2021_tesla_model-3_long-range

Description

Unique identifier for a year/make/model/trim combination maintained by VinAudit’s Specifications API. If both spec_id and spec_vin are specified, spec_id takes precedence.

Supports:

  • year

  • year_make

  • year_make_model

  • year_make_model_trim

  • make

  • make_model

  • make_model_trim

Parameter

listing_type

optional

Example

Used

Description

Type of vehicle listing. Defaults to New, Used, Certified

Parameter

listing_price_min

optional

Example

54700

Description

Minimum latest listing price

Parameter

listing_price_max

optional

Example

75000

Description

Maximum latest listing price

Parameter

postal

optional

Example

30680

Description

Seller postal/ZIP code. The default search radius is 25 miles (or kilometers in Canada) from this postal code.

Parameter

latitude

optional

Example

34.391663

Description

Seller latitude component. The default search radius is 25 miles (or kilometers in Canada) from this coordinate.

Parameter

longitude

optional

Example

-118.542587

Description

Seller longitude component. The default search radius is 25 miles (or kilometers in Canada) from this coordinate.

Parameter

radius

optional

Example

50

Description

Radius to search listings around one of the following, in priority order:

  • seller_id

  • latitude + longitude

  • postal

Depending on country, radius is in miles (USA) or kilometers (Canada). Default: 25.

Parameter

city

optional

Example

Winder

Description

Seller city. Note: If city is set, then region is required

Parameter

region

optional

Example

GA

Description

2-letter abbreviation for state, province, or territory

Parameter

country

optional

Example

usa

Description

Country filter and unit selector.

Options:

  • usa (default)

  • canada

  • If usa: prices in USD, distances in miles.

  • If canada: prices in CAD, distances in kilometers

Parameter

seller_type

optional

Example

independent

Description

Type of dealership.

Options:

  • franchise

  • independent

  • private

Default: franchise, independent

Parameter

seller_id

optional

Example

dealername_winder_ga

Description

VinAudit Seller ID. The default search radius is 25 miles (or kilometers in Canada) from the seller’s location.

Parameter

dealer_attribution

optional

Example

2

Description

Vehicle dealer attribution level

Parameter

spec_accuracy

optional

Example

2

Description

Vehicle specification accuracy level

Parameter

listing_status

optional

Example

all

Description

Filter vehicles by listing status.

Supports one or more comma-separated values:

  • in-transit – Pending sale due to being transported

  • active – Recently listed for sale within the last 5 days (default)

  • dropped – No longer actively listed for sale (likely sold)

  • all – Returns all statuses (active, in-transit, dropped)

Default: active, in-transit.

Parameter

history_days

optional

Example

90

Description

Number of days in the past to look back for dropped listings (default: 30). Applies only if listing_status includes dropped listings.

Parameter

vehicle_type

optional

Example

sedan

Description

Body type of vehicle.

Options:

  • sedan

  • coupe

  • truck

  • suv

  • hatchback

  • van

  • wagon

  • convertible

  • minivan

Parameter

vehicle_fuel_type

optional

Example

electric

Description

Type of fuel:

  • diesel

  • electric

  • flex

  • gasoline

  • hybrid

  • hydrogen

  • plug-in

Parameter

vehicle_engine_cylinders

optional

Example

6

Description

Number of engine cylinders

Parameter

vehicle_transmission_type

optional

Example

automatic

Description

Type of transmission.

Options:

  • automatic

  • manual

Parameter

vehicle_drivetrain

optional

Example

awd

Description

Vehicle drivetrain.

Options:

  • rwd

  • fwd

  • awd

  • 4wd

Parameter

vehicle_doors

optional

Example

4

Description

Number of doors on the vehicle

Parameter

page_size

optional

Example

100

Description

Number of listings returned per page (default: 100)

Parameter

page

optional

Example

1

Description

Result page number, starting at 1 (default: 1)

Response Attributes

Field

total

Example

100

Description

Number of listings returned in the current page

Field

query_total

Example

26641276

Description

Total listings matching the query across all pages

Field

page

Example

1

Description

Page number of the current result set

Field

page_size

Example

100

Description

Number of listings requested per page

Field

id

Example

100156230567254855

Description

Unique listing ID

Field

vin

Example

1GCUDEE8XRZ272968

Description

Vehicle Identification Number (when available)

Field

trim_id

Example

2024_chevrolet_silverado-1500_rst

Description

Vehicle trim ID (compatible with VinAudit’s Specifications API)

Field

vehicle_style_id

Example

2024_chevrolet_silverado-1500_rst-157_crew-cab-4wd

Description

Vehicle style identifier

Field

listing_date

Example

4/27/2023

Description

Date the vehicle was first seen online

Field

listing_drop_date

Example

5/13/2023

Description

Date the vehicle was last seen online. Note: This field will be retired on December 2025.

Field

date_dropped

Example

5/13/2023

Description

Date the VIN was confirmed as no longer listed

Field

date_max

Example

5/13/2023

Description

Most recent date the vehicle was seen online

Field

days_seen

Example

17

Description

Number of days the listing was seen online (from first to last sighting)

Field

listing_title

Example

2024 Chevrolet 1500 RST 4WD

Description

Vehicle listing title

Field

listing_subtitle

Example

Silverado 1500 Truck

Description

Vehicle listing subtitle

Field

listing_description

Example

GREAT MILES 40,638! $1,000 below J.D. Power Retail!, EPA 26 MPG Hwy/19 MPG City! Heated Seats, Moonroof

Description

Raw listing description text posted by the seller

Field

listing_features

Example

Leather Seats, Sunroof/Moonroof, Navigation System, Adaptive Cruise Control

Description

Raw list of vehicle equipment advertised by the seller.

Field

listing_mileage

Example

19428

Description

Vehicle odometer reading in the country’s distance unit (e.g., miles for US)

Field

listing_price

Example

54700

Description

Latest listing price in the country’s currency (e.g., USD for US).

Field

listing_status

Example

active

Description

Vehicle listing status: active, in-transit, or dropped

Field

listing_vdp_url

Example

https://www.dealername.com/vehicle/3868258

Description

Vehicle detail page URL.

Field

listing_stock

Example

PH01478

Description

Stock number assigned by seller

Field

listing_type

Example

new

Description

Listing type: new, used, or certified

Field

certified_flag

Example

false

Description

Indicates whether the vehicle is certified pre-owned

Field

price_history

Example

[{ date: 2025-07-16, price: 23999 }]

Description

Array of historical prices with date and price entries

Field

seller_id

Example

chevrolet-auto-sales_ny

Description

VinAudit Seller ID

Field

seller_type

Example

Franchise

Description

Seller type: Independent, Franchise, or Private.

Field

seller_makes

Example

Chevrolet

Description

List of franchise brands (for Franchise dealers)

Field

name

Example

Chevrolet Auto Sales

Description

Seller name (typically a dealership name)

Field

address

Example

12 Dale Dr

Description

Seller address

Field

city

Example

Binghamton

Description

Seller city

Field

region

Example

NY

Description

Seller state, province, or territory

Field

postal

Example

13905

Description

Seller postal/ZIP code

Field

county

Example

Hamilton

Description

Seller county

Field

country

Example

USA

Description

Seller country: USA or Canada

Field

latitude

Example

33.92929292

Description

Seller address latitude

Field

longitude

Example

-111.111

Description

Seller address longitude

Field

domains

Example

dealername.com

Description

List of seller domains

Field

websites

Example

https://www.dealername.com

Description

List of seller websites

Field

phones

Example

855-555-5555

Description

List of seller phone numbers

Field

vehicle_year

Example

2024

Description

Vehicle year

Field

vehicle_specs_year

Example

2024

Description

Vehicle year from the Specifications API

Field

vehicle_make

Example

Chevrolet

Description

Vehicle make

Field

vehicle_specs_make

Example

Chevrolet

Description

Vehicle make from the Specifications API

Field

vehicle_model

Example

Silverado 1500

Description

Vehicle model

Field

vehicle_specs_model

Example

Silverado 1500

Description

Vehicle model from the Specifications API

Field

vehicle_trim

Example

RST

Description

Vehicle trim

Field

vehicle_specs_trim

Example

RST

Description

Vehicle trim from the Specifications API

Field

vehicle_style

Example

Crew Cab 4WD

Description

Vehicle style

Field

vehicle_specs_style

Example

Crew Cab 4WD

Description

Vehicle style from the Specifications API

Field

vehicle_type

Example

Truck

Description

Vehicle type (e.g., sedan, SUV, truck)

Field

vehicle_specs_type

Example

Truck

Description

Vehicle type from the Specifications API

Field

vehicle_doors

Example

4

Description

Number of vehicle doors

Field

vehicle_specs_doors

Example

4

Description

Number of vehicle doors from the Specifications API

Field

vehicle_engine

Example

3.0L Duramax Turbo Diesel engine

Description

Vehicle engine description

Field

vehicle_specs_engine

Example

3.0L Duramax Turbo Diesel engine

Description

Engine description from the Specifications API

Field

vehicle_engine_size

Example

3.0

Description

Engine size in liters

Field

vehicle_engine_cylinders

Example

6

Description

Number of engine cylinders

Field

vehicle_specs_engine_cylinders

Example

6

Description

Number of engine cylinders from the Specifications API

Field

vehicle_fuel_type

Example

Diesel

Description

Vehicle fuel type

Field

vehicle_specs_fuel_type

Example

Diesel

Description

Fuel type from the Specifications API

Field

vehicle_transmission

Example

8-Speed Automatic

Description

Vehicle transmission summary

Field

vehicle_specs_transmission

Example

8-Speed Automatic

Description

Transmission summary from the Specifications API

Field

vehicle_transmission_speed

Example

8

Description

Number of transmission gears

Field

vehicle_transmission_type

Example

Automatic

Description

Transmission type (automatic, manual)

Field

vehicle_drivetrain

Example

Four-Wheel Drive

Description

Vehicle drivetrain

Field

vehicle_specs_drivetrain

Example

Four-Wheel Drive

Description

Drivetrain from the Specifications API

Field

vehicle_fuel_capacity

Example

24

Description

Fuel tank capacity

Field

vehicle_color_exterior

Example

Eminent White Pearl Exterior

Description

Exterior color

Field

vehicle_color_interior

Example

Rioja Red Leatherette

Description

Interior color

Field

vehicle_fuel_efficiency

Example

17

Description

Combined fuel efficiency

Field

vehicle_fuel_efficiency_city

Example

15

Description

City fuel efficiency

Field

vehicle_fuel_efficiency_highway

Example

20

Description

Highway fuel efficiency

Field

vehicle_gross_weight_rating

Example

8000

Description

Gross Vehicle Weight Rating (GVWR)

Field

vehicle_truck_bed_style

Example

Short Bed

Description

Bed style (for pickup trucks)

Field

vehicle_truck_cab_style

Example

Crew Cab

Description

Cab style (for pickup trucks)

Example Query (Search by Make)

REQUEST:

https://marketlistings.vinaudit.com/v1/listings?
key=YOUR_API_KEY_HERE
&format=xml
&spec_id=toyota
&page_size=100
&page=1

Example Call (Search by Specific Spec ID)

REQUEST:

https://marketlistings.vinaudit.com/v1/listings?
country=usa
&format=xml
&page_size=1
&page=1
&key=YOUR_API_KEY_HERE
&spec_id=2021_tesla_model-3_long-range

Example Response

xml
<result>
  <input>
    <country>usa</country>
    <format>xml</format>
    <page_size>1</page_size>
    <page>1</page>
    <key>YOUR_API_KEY_HERE</key>
    <spec_id>2021_tesla_model-3_long-range</spec_id>
  </input>
  <pagination>
    <total>1</total>
    <query_total>2003</query_total>
    <page>1</page>
    <page_size>1</page_size>
  </pagination>
  <success>true</success>
  <listings>
    <listing>
      <id>1243092745610925177</id>
      <vin>5YJ3E1EB2MF050615</vin>
      <trim_id>2021_tesla_model-3_long-range</trim_id>
      <vehicle_style_id>2021_tesla_model-3_long-range_v4</vehicle_style_id>
      <days_seen>54</days_seen>
      <listing_date>2025-09-10</listing_date>
      <listing_drop_date>2025-11-02</listing_drop_date>
      <date_dropped />
      <date_max>2025-11-02</date_max>
      <listing_title>2021 Tesla Model 3</listing_title>
      <listing_subtitle />
      <listing_stock>2004044803</listing_stock>
      <listing_price>26590</listing_price>
      <listing_type>Used</listing_type>
      <listing_mileage>49512</listing_mileage>
      <listing_status>active</listing_status>
      <listing_vdp_url>https://www.domainname.com/vehicle/3868258</listing_vdp_url>
      <listing_portal_urls>https://www.domainname.com/vehicle/3929822</listing_portal_urls>
      <listing_description />
      <listing_features>{'Braking &amp; Traction': ['Hill Assistance', 'Electronic Stability Control', 'Traction Control', 'Stability Control', 'Intelligent Traction Control', 'Rollover Mitigation', 'Anti-Lock Brakes'], 'Comfort &amp; Convenience': ['Tilt Wheel', 'Power Tailgate/Hatch', 'Cruise Control', 'Keyless Entry', 'Power Windows', 'Power Mirrors', 'Air Conditioning', 'Power Locks', 'Remote Start', 'Power Adjustable Steering Column', 'Automatic Air Conditioning', 'Multi-Zone Climate Control', 'Automatic Windshield Wipers', 'Compass', 'Power Lumbar Support', '12V Power Outlet', 'Heated Steering Wheel'], 'Entertainment &amp; Technology': ['GPS Navigation', 'Hands Free Calling', 'Bluetooth Music', 'USB Input', 'Real-Time Traffic Information', 'Steering Wheel Controls', 'Touch Screen Monitor', 'Performance Monitoring', 'Voice Recognition System'], 'Lighting': ['LED Headlamps', 'Daytime Running Lights', 'Automatic Headlights', 'LED Tail Lights', 'Automatic High Beams', 'LED Daytime Running Lights'], 'Roof &amp; Glass': ['Rear Window Defroster'], 'Safety &amp; Security': ['Alarm System', 'Collision Detection', 'Adaptive Cruise Control', 'Automatic Emergency Braking', 'Rear View Camera', 'Blindspot Sensors', 'Side View Cameras', 'Auto Dimming Mirrors', 'Child Seat Anchors', 'Driver Airbag', 'Front Head Curtain Airbag', 'Front Side Airbag', 'Passenger Airbag', 'Rear Head Curtain Airbag', 'Lane Departure Warning', 'Active Lane Keep Assistance', 'Parking Assistance', 'Pedestrian Detection', 'Stolen Vehicle Tracking Software', 'Driver Knee Airbag', 'Front Knee Airbag', 'Traffic Sign Recognition', 'Front View Camera'], 'Seating &amp; Interior': ['Power Driver Seat', 'Heated Seats', 'Power Passenger Seat', 'Fold Down Rear Seats', 'Synthetic Leather Seats', 'Interior Ambient Lighting', 'Seat Memory System'], 'Wheels &amp; Tires': ['Alloy Wheels', 'Limited Use Spare', 'Tire Pressure Monitor']}</listing_features>
      <certified_flag>False</certified_flag>
      <price_history>
        <entry>
          <date>2025-09-15</date>
          <price>26990</price>
        </entry>
        <entry>
          <date>2025-10-10</date>
          <price>26590</price>
        </entry>
      </price_history>
      <vehicle_year>2021</vehicle_year>
      <vehicle_make>Tesla</vehicle_make>
      <vehicle_model>Model 3</vehicle_model>
      <vehicle_trim>Long Range</vehicle_trim>
      <vehicle_type />
      <vehicle_style>Sedan 4d</vehicle_style>
      <vehicle_color_exterior>Blue</vehicle_color_exterior>
      <vehicle_color_interior>Black</vehicle_color_interior>
      <vehicle_truck_cab_style />
      <vehicle_truck_bed_style />
      <vehicle_engine>Electric</vehicle_engine>
      <vehicle_engine_size />
      <vehicle_engine_cylinders />
      <vehicle_transmission>single-Speed fixed gear</vehicle_transmission>
      <vehicle_transmission_type />
      <vehicle_transmission_speed />
      <vehicle_drivetrain>All-Wheel Drive</vehicle_drivetrain>
      <vehicle_doors>4-Door</vehicle_doors>
      <vehicle_gross_weight_rating />
      <vehicle_fuel_type>Electric</vehicle_fuel_type>
      <vehicle_fuel_efficiency />
      <vehicle_fuel_efficiency_city />
      <vehicle_fuel_efficiency_highway />
      <vehicle_fuel_capacity />
      <vehicle_history_critical_count>0</vehicle_history_critical_count>
      <vehicle_history_accident_count>0</vehicle_history_accident_count>
      <vehicle_history_theft_count>0</vehicle_history_theft_count>
      <vehicle_history_salvage_count>0</vehicle_history_salvage_count>
      <vehicle_wheelbase />
      <safety_rating_overall />
      <seller_id>dealername_winder_ga</seller_id>
      <seller_type>Independent</seller_type>
      <seller_makes />
      <name>DealerName</name>
      <address> </address>
      <city>Winder</city>
      <region>GA</region>
      <postal>30680</postal>
      <county />
      <country>USA</country>
      <websites />
      <domains />
      <phones />
      <latitude />
      <longitude />
    </listing>
  </listings>
</result>

Search Tips

• Outside of the API key, each input parameter is optional and can be combined for targeted searches.

• Search results are paginated using page and page_size. For example, use page=2 and page_size=50 to view the second page with 50 listings per page.

• The response includes pagination details. total shows the number of listings in the current page, while query_total shows the total number of listings matching the query. Use query_total ÷ page_size to estimate the total number of pages.

• Use spec_id to search by vehicle year, make, model, and trim. Supported formats include year, year_make, year_make_model, year_make_model_trim, make, make_model, and make_model_trim.

• Search multiple values by separating them with commas, such as spec_id=ford,toyota or spec_id=2020_ford,2021_ford,2022_ford.

• Combine vehicle descriptors with location parameters to search within a specific area. For example: spec_id=2024_chevrolet_silverado-1500&postal=12345&radius=50.

• Use vehicle_make with location parameters such as postal, radius, or latitude/longitude to search listings for a specific make in an area.

• To query listings from one dealer only, use seller_id with radius=0.

• When using seller_id with radius, add postal to further narrow results to a specific postal code area.

Ready to build?

Access the Market Listings API with a free developer account. No credit card required.

Start Free TrialView API Docs