Vehicle Listings API

Get comprehensive vehicle listings from U.S. physical & online dealers in seconds. Our Vehicle Listings API provides detailed vehicle information, dealership data, specifications, and market pricing.

Endpoints

Get All Listings

GET https://api.auto.dev/listings

Returns an array of vehicle listings (typically 100 per page).

Get Specific VIN Listing

GET https://api.auto.dev/listings/{vin}

Returns a single listing for the specified VIN.

Parameters

Example Request

curl -X GET "https://api.auto.dev/listings/10ARJYBS7RC154562" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response Structure

Single Listing Object Structure

Both endpoints return listing objects with the same structure, but wrapped differently:

• /listings wraps them in: {data: [array of listing objects]}
• /listings/{vin} wraps them in: {data: {single listing object}}

Each listing object contains:

Example Responses

Use Cases

• Marketplace Applications: Display comprehensive vehicle listings with photos and pricing
• Inventory Management: Track dealer inventory and pricing changes
• Price Comparison: Compare market prices across different dealers

Error Responses

Invalid Parameter

{
  "status": 400,
  "error": "Invalid parameter provided: make. This parameter does not exist in this endpoint.",
  "code": "INVALID_PARAMETER",
  "path": "/listings",
  "requestId": "966e8386bb38f095"
}

Invalid VIN

{
  "status": 400,
  "error": "Invalid VIN format: \"123INVALID\" - VIN must be exactly 17 characters",
  "code": "INVALID_VIN_FORMAT",
  "path": "/listings/123INVALID",
  "requestId": "a1b2c3d4e5f6g7h8"
}

VIN Not Found

{
  "status": 404,
  "error": "Resource \"WP0AF2A99KS165242\" not found",
  "code": "RESOURCE_NOT_FOUND",
  "path": "/listings/WP0AF2A99KS165242",
  "requestId": "966716ac29ed8147"
}

Plan Availability

• Starter: ✅ Available
• Growth: ✅ Available
• Scale: ✅ Available

See pricing for plan details and signup.