Kelley Blue Book · Listings
kbb-com/vehicles/listingsGet product, price and seller data with Kelley Blue Book · Listings from Alexandria through one Spiral API key. Search kbb.com dealer and private-seller inventory for a make (optionally model and trim) within a radius of a US ZIP code, optionally filtered by year, price, maximum mileage, exterior colour and drivetrain. It runs in the background and returns structured JSON. Pay as you go, with no subscription.
Pricing
$0.00873 per call.
Limits
- Runs
- In the background
- Returns
- json
- Longest queue wait
- 1 hour
- Run deadline
- 5 minutes
- Longest run, end to end
- 225 minutes
- Largest inline input
- 1 MB
- Largest input file
- 2 GB
- Largest output
- 5 GB
Input
| Field | Kind | Default | Description |
|---|---|---|---|
zip required | text | — | Five-digit US ZIP code at the centre of the search. Pattern: ^[0-9]{5}$. |
make required | text | — | kbb.com make slug, e.g. toyota, honda, ford, mercedes-benz. |
page | number 1 to 40 | 1 | Result page; 25 listings per page. |
sort | one of relevance, price_asc, price_desc, mileage_asc, year_desc, distance_asc, newest | relevance | Result order: relevance (KBB default), price_asc / price_desc by KBB derived price (advertised price plus fees, so advertised prices are only approximately ordered), mileage_asc, year_desc (newest model year first), distance_asc (nearest seller first), newest (most recently listed first). |
trim | text | — | Trim name as shown in listings (e.g. SE, XLE, Sport Touring). Requires model. |
model | text | — | kbb.com model slug, e.g. camry, civic, f150, model-3. Powertrain variants are not separate models (Kona Electric is kona, Bolt EV is bolt); an unknown slug fails with not_found naming the make's valid slugs. Omit for all models of the make. |
year_max | number 1981 to 2030 | — | Newest model year to include, inclusive; must not be below year_min. |
year_min | number 1981 to 2030 | — | Oldest model year to include, inclusive. |
price_max | number 0 to … | — | Highest advertised price to include, in whole US dollars; must not be below price_min. |
price_min | number 0 to … | — | Lowest advertised price to include, in whole US dollars. |
drive_type | one of awd, 4wd, fwd, rwd | — | Drivetrain group. kbb.com groups AWD and 4WD together, so awd and 4wd return the same listings (drive_type AWD4WD). |
mileage_max | number 1 to 999999 | — | Only listings with at most this many miles on the odometer (kbb.com maxMileage filter; any ceiling, not just the site's 10,000-mile steps). |
listing_type | one of used, new, certified, all | used | Inventory to search: used, new, certified pre-owned, or all three. Defaults to used. |
radius_miles | one of 0, 10, 25, 50, 75, 100, 200, 300, 400, 500 | 50 | Search radius in miles; 0 means nationwide. KBB pads a market's results with remote 'virtual dealer' delivery listings whose distance is not the seller's; with a non-zero radius these are excluded (count may be below page_size while total_count still includes them). |
exterior_color | one of beige, black, blue, brown, burgundy, charcoal, gold, gray, green, off_white, orange, pink, purple, red, silver, tan, turquoise, white, yellow | — | kbb.com exterior colour group; matches the manufacturer colour names in |
Same request in code
curl https://api.spiral.ai/v1/runs \
-H "Authorization: Bearer $SPIRAL_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"provider": "alexandria",
"model": "kbb-com/vehicles/listings",
"input": {
"zip": "<zip>",
"make": "<make>"
}
}'Frequently asked questions
How much does Kelley Blue Book · Listings cost?
$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.
How do I use Kelley Blue Book · Listings through an API?
Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "kbb-com/vehicles/listings"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.
Do I need an account with Alexandria to use Kelley Blue Book · Listings?
No. Spiral runs it on its own Alexandria account and charges your Spiral balance.
Can my AI agent use Kelley Blue Book · Listings?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.