Auto.dev

Search Vehicle Listings

Get comprehensive vehicle listings from U.S. physical & online dealers. Returns an array of listings with detailed vehicle information, dealership data, specifications, and market pricing.

GET
/listings
AuthorizationBearer <token>

Use your API key in the Authorization header: Authorization: Bearer YOUR_API_KEY

In: header

Query Parameters

page?integer

Page number to retrieve (starting from 1)

Default1
limit?integer

Number of listings to return per page (1-100)

Default100
Range1 <= value <= 100
sort?string

Sort criteria

Default""
Value in"" | "price.asc" | "price.desc" | "year.asc" | "year.desc" | "mileage.asc" | "mileage.desc"
vehicle.year?string

The year of the vehicle. Use specific year (2018) or range (2018-2020)

Default""
vehicle.make?string

Vehicle manufacturer. Use comma for multiple: Ford,Chevrolet

Default""
vehicle.model?string

Vehicle model. Use comma for multiple: F-150,Silverado

Default""
vehicle.trim?string

Trim level. Use comma for multiple: XLT,LT

Default""
vehicle.bodyStyle?string

Body style. Use comma for multiple: sedan,coupe

Default""
vehicle.engine?string

Engine size. Use comma for multiple: 2.0L,3.5L

Default""
vehicle.transmission?string

Transmission type. Use comma for multiple: automatic,manual

Default""
vehicle.interiorColor?string

Exterior color. Use comma for multiple: white,black

Default""
vehicle.exteriorColor?string

Exterior color. Use comma for multiple: white,black

Default""
vehicle.doors?integer

Number of doors (2, 4, 5)

Default0
retailListing.price?string

Vehicle price. Use range: 10000-20000

Default""
retailListing.state?string

State where vehicle is located (e.g., CA)

Default""
retailListing.miles?string

Vehicle mileage. Use range: 10000-20000

Default""

Response Body

curl -X GET "https://api.auto.dev/listings?page=1&limit=100&sort=&vehicle.year=&vehicle.make=&vehicle.model=&vehicle.trim=&vehicle.bodyStyle=&vehicle.engine=&vehicle.transmission=&vehicle.interiorColor=&vehicle.exteriorColor=&vehicle.doors=0&retailListing.price=&retailListing.state=&retailListing.miles="

{
  "data": [
    {
      "@id": "https://api.auto.dev/listings/10ARJYBS7RC154562",
      "vin": "10ARJYBS7RC154562",
      "location": [
        -77.0334,
        40.2476
      ],
      "online": true,
      "vehicle": {
        "vin": "10ARJYBS7RC154562",
        "squishVin": "10ARJYBSRC",
        "year": 2024,
        "make": "Jeep",
        "model": "Grand Cherokee",
        "trim": "4xe",
        "drivetrain": "4WD",
        "engine": "Plug-In Hybrid",
        "fuel": "Plug-In Hybrid",
        "transmission": "Automatic",
        "confidence": 0.005,
        "doors": 4,
        "seats": 5
      },
      "wholesaleListing": null,
      "retailListing": {
        "vdp": "http://details.vast.com/details/cars/...",
        "price": 0,
        "used": false,
        "cpo": false,
        "carfaxUrl": "https://www.carfax.com/VehicleHistory/p/Report.cfx?vin=10ARJYBS7RC154562&partner=FRD_2",
        "dealer": "Faulkner Dodge Ram Mechanicsburg New",
        "city": "Mechanicsburg",
        "state": "PA",
        "zip": "17050",
        "primaryImage": "https://retail.photos.vin/10ARJYBS7RC154562-1.jpg",
        "photoCount": 1
      },
      "history": null
    }
  ]
}