docs / api / market / listings

Market Listings API

The Market Listings API provides access to retail vehicle listings across the United States and Canada. Access requires an API-enabled account and a unique API key issued by VinAudit. This API key authenticates your application and authorizes requests to VinAudit’s API servers.

GET

https://marketlistings.autodata.com/v1/listings

Request Parameters

Parameter

key

required

Example

YOUR_API_KEY

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

Description

Unique identifier for year/make/model/trim combination.

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	Description	Example
keyrequired	Your account API key	YOUR_API_KEY
formatoptional	Output format. Options: json (default), xml	json
vinoptional	Search listings for a specific Vehicle Identification Number	5YJ3E1EB2MF050615
vehicle_makeoptional	Filter listings for a particular vehicle make within a specific area	Tesla
spec_vinoptional	A reference VIN used to find listings with similar year, make, model	5YJ3E1EB2MF050615
spec_vin_matchoptional	How to match listings similar to spec_vin. Options: model, trim.	model
spec_idoptional	Unique identifier for year/make/model/trim combination.	2021_tesla_model-3_long
listing_typeoptional	Type of vehicle listing. Defaults to New, Used, Certified	Used
listing_price_minoptional	Minimum latest listing price	54700

Response Attributes

Field

total

Type

integer

Description

Number of listings returned in the current page

Field

query_total

Type

integer

Description

Total listings matching the query across all pages

Field

page

Type

integer

Description

Page number of the current result set

Field	Description	Type
total	Number of listings returned in the current page	integer
query_total	Total listings matching the query across all pages	integer
page	Page number of the current result set	integer

Example Request

HTTP

GET https://marketlistings.autodata.com/v1/listings
?key=YOUR_API_KEY
&spec_id=2021_tesla_model-3_long-range
&country=usa
&page_size=1
&page=1
&format=json

Example Response

JSON

{
  "success": true,
  "pagination": {
    "total": 1,
    "query_total": 2003,
    "page": 1,
    "page_size": 1
  },
  "listings": [
    {
      "id": "1243092745610925177",
      "vin": "5YJ3E1EB2MF050615",
      "trim_id": "2021_tesla_model-3_long-range",
      "listing_date": "2025-09-10",
      "listing_price": 26590,
      "listing_mileage": 49512,
      "listing_type": "Used",
      "listing_status": "active",
      "vehicle_year": 2021,
      "vehicle_make": "Tesla",
      "vehicle_model": "Model 3",
      "vehicle_trim": "Long Range",
      "vehicle_drivetrain": "All-Wheel Drive",
      "vehicle_color_exterior": "Blue",
      "seller_id": "dealername_winder_ga",
      "seller_type": "Independent",
      "city": "Winder",
      "region": "GA",
      "country": "USA",
      "price_history": [
        {
          "date": "2025-09-15",
          "price": 26990
        },
        {
          "date": "2025-10-10",
          "price": 26590
        }
      ]
    }
  ]
}

Search Tips

Unlock instant All parameters except key are optional — combine freely for targeted searches
Use spec_id=ford,toyota to search multiple makes at once
Set radius=0 with seller_id to return only that exact dealer's inventory
Combine spec_id, postal, and radius to find specific vehicles near a location
Use query_total ÷ page_size to calculate total pages available to Automotive Market Data across the U.S. and Canada with just a few lines of code.

Ready to build ?

Access the Market Listings and Market Values APIs with a free developer account. No credit card required.