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.
Use your API key in the Authorization header: Authorization: Bearer YOUR_API_KEY
In: header
Query Parameters
Page number to retrieve (starting from 1)
1Number of listings to return per page. Maximum 500. Per-plan caps (Free/Starter: 20, Growth: 100, Scale: 500) will be enforced in a future release; callers will be emailed before the change ships.
1001 <= value <= 500Opaque pagination token. Issued by the API in links.next at page 50+. Conflicts with ?page= — pick one mode. Follow the emitted cursor URL rather than constructing manually.
Sort field with optional direction. Format: or .. Supported fields: createdAt, updatedAt, price, miles, mileage, year. Direction: asc or desc (default asc). Default when omitted: updatedAt.desc. Single field only; multi-column sort, random, and distance are not supported.
"updatedAt.desc""createdAt" | "createdAt.asc" | "createdAt.desc" | "updatedAt" | "updatedAt.asc" | "updatedAt.desc" | "price" | "price.asc" | "price.desc" | "miles" | "miles.asc" | "miles.desc" | "mileage" | "mileage.asc" | "mileage.desc" | "year" | "year.asc" | "year.desc"The year of the vehicle. Use specific year (2018) or range (2018-2020)
""Vehicle manufacturer. Use comma for multiple: Ford,Chevrolet
""Vehicle model. Use comma for multiple: F-150,Silverado
""Trim level. Use comma for multiple: XLT,LT
""Body style. Use comma for multiple: sedan,coupe
""Engine size. Use comma for multiple: 2.0L,3.5L
""Transmission type. Use comma for multiple: automatic,manual
""Exterior color. Use comma for multiple: white,black
""Exterior color. Use comma for multiple: white,black
""Number of doors (2, 4, 5)
0Vehicle price. Use range: 10000-20000
""State where vehicle is located (e.g., CA)
""Vehicle mileage. Use range: 10000-20000
""Used vs new. true for used vehicles, false for new.
Certified Pre-Owned flag. true filters to CPO listings.
Fuel type. Use comma for multiple: Gasoline,Hybrid,Electric,Plug-In Hybrid,Diesel.
""5-digit ZIP code to center the search around. Pair with distance for radius search.
""Radius in miles from the zip ZIP code to include in results.
50Canonical dealer ID(s). Use comma for multiple: dlr_123,dlr_456.
""ZIP code(s) the dealer is located in. Distinct from the top-level zip (buyer-center for radius search). Use comma for multiple.
""Opt in to listings with retailListing.price = null. Off by default; zero/null-price rows are filtered out unless set to true.
falseOpt-in response extensions. total adds "total": <number> (matching rows ignoring pagination). facets adds a "facets": {...} object with bucketed counts and drill-down URLs per filterable dimension. Pass either or both as a comma-separated list; order is not significant (?includes=total,facets and ?includes=facets,total are equivalent).
Comma-separated list of field paths to project, e.g. vehicle.vin,vehicle.year,retailListing.price. Nested fields require dot notation (vehicle.vin, not vin); top-level fields without a nested equivalent (createdAt, updatedAt, location) use their bare name. When set, data[] rows come back with flat dot-keyed properties (e.g. "vehicle.year": 2025) rather than the nested objects of the default response. Omit to receive the full default response.
17-character VIN to filter on as a query parameter. Equivalent to the /listings/{vin} path form but returns an array wrapper instead of a single-listing wrapper.
Response Body
curl -X GET "https://api.auto.dev/listings?page=1&limit=100&cursor=string&sort=createdAt&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=&retailListing.used=true&retailListing.cpo=true&vehicle.fuel=&zip=&distance=50&dealerId=&dealerZip=&includeUnpriced=false&includes=total&select=string&vin=string"{
"data": [
{
"@id": "https://api.auto.dev/listings/10ARJYBS7RC154562",
"vin": "10ARJYBS7RC154562",
"location": [
-77.0334,
40.2476
],
"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
}
]
}