Skip to content

Marketplace

Vehicle Listings API

Get comprehensive vehicle listings from U.S. physical & online dealers in seconds.

Get startedRead the docs
npm install -g @auto.dev/sdk
{  "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/ob-48ae10cec45c5264c0c05239af7ac2c3eda678223f9171ac63be6a3107cd3db63b027b96ef83ac88fd6ccb42933d4f3c6bf26f82a637df6dbf6160746a741de2e12135dcbeff82654b855069fa243842784cfba33bf3b93b6d5a9156baa8b0f948d0b715b4936664c48f9fdb248501ca1a015077c28df814c6ae254e205e6b8afb7f16011f22412ebedeee38685f0721f74c31246e538ff42db94d2ceb09e6950fb15e40f90d9a2a0fa486f173a58cc4/?pl=19",      "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  }}

In short

Vehicle Listings returns active U.S. dealer listings from physical and online dealers, with the vehicle, price, new or used status, dealer, location, Carfax link and photos. Send GET /listings/{vin} for one car, or search with query parameters. It is included on the Free plan, then costs $0.0015 per call on Growth and $0.001 on Scale.

What it returns

  • Vehicle details
  • Retail price
  • New, used or certified
  • Dealer and location
  • Listing page and Carfax link
  • Primary photo

Hand this page to your agent

Open inChatGPTClaudePerplexityGrokMuseGoogle AI StudioDevin
Install inCursorVS CodeOpenClaw

From a terminal, an agent or your code

The CLI, the MCP tools and the SDK return the data with API metadata stripped. Add --raw on the CLI, or raw: true in the SDK, for the full response.

CLI

In a terminal, after auto login. Add --json or --yaml to choose the format.

Terminal
auto listings --make Jeep --model "Grand Cherokee"
MCP

auto_listings, hosted or local, in any MCP client. Arguments are strings.

tools/call auto_listings
{ "make": "Jeep", "model": "Grand Cherokee" }
SDK

TypeScript, from npm install @auto.dev/sdk. Every method resolves to { data, meta }.

index.ts
import { AutoDev } from "@auto.dev/sdk"const auto = new AutoDev({ apiKey: process.env.AUTODEV_API_KEY }) const { data } = await auto.listings({  "vehicle.make": "Jeep",  "vehicle.model": "Grand Cherokee",})

Request reference

One GET request with your API key. JSON comes back.

Endpoint

GEThttps://api.auto.dev/listings/{vin}

Path parameter

1 required
  • vinstringrequired

    17-character Vehicle Identification Number (letters and digits, excluding I, O, and Q).

    10ARJYBS7RC154562

Authentication

Use any one
  • HeaderAuthorization: Bearer <key>
  • HeaderX-API-Key: <key>
  • Query?apiKey=<key>

Rate limits

Requests per second
  • 5Free
  • 10Growth
  • 50Scale

Vehicle Listings pricing

Included on Free. Paid plans bill each call on top of the subscription.

Free

Includedwithin 1,000 calls a month
Plan
$0
Rate limit
5 req/s
Get started

Growth

$0.0015per call
Plan
$299/mo
Rate limit
10 req/s
Start 7-day trial

Scale

$0.001per call
Plan
$599/mo
Rate limit
50 req/s
Start 7-day trial
Looking for Enterprise?Compare plans

Vehicle Listings questions

Have other questions? Check out our docs or .

What does the Vehicle Listings API return?

Vehicle details, retail price, new, used or certified, dealer and location, listing page and Carfax link, primary photo. Every response is JSON from https://api.auto.dev/listings/{vin}.

How much does the Vehicle Listings API cost?

Vehicle Listings is included on the Free plan, which has 1,000 API calls a month and no card required. On paid plans it costs $0.0015 per call on Growth and $0.001 per call on Scale, on top of the plan's subscription.

How do I call the Vehicle Listings API?

Send GET /listings/{vin} to api.auto.dev with your API key as a Bearer token in the Authorization header, or as an apiKey query parameter. The path takes vin, the 17-character Vehicle Identification Number (letters and digits, excluding I, O, and Q).

What are the rate limits for Vehicle Listings?

Rate limits follow your plan: 5 requests per second on Free, 10 on Growth and 50 on Scale.

Can AI agents use the Vehicle Listings API?

Yes. Connect the hosted MCP server, https://mcp.auto.dev/mcp, and agents such as Claude Code and Cursor call it as the auto_listings tool, signing in with OAuth instead of an API key. Or run it locally: npm install -g @auto.dev/sdk, then auto login and auto mcp install.

Pairs well with

This VIN works on every other endpoint, so one lookup becomes a full record.

  • Vehicle Photos

    High-quality vehicle images and photo galleries for listings and inventory.

    GET /photos/{vin}

  • Global VIN Decode

    Decode any VIN to access comprehensive vehicle data and specifications.

    GET /vin/{vin}

  • Specifications

    Detailed technical specifications, features, and options for any vehicle model.

    GET /specs/{vin}

Build with Vehicle Listings

Choose your plan and get your API key.

Get startedRead docs