# Kelley Blue Book · Listings

Get 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.

- Provider: Alexandria
- Category: E-commerce
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `kbb-com/vehicles/listings`
- Page: https://spiral.ai/tools/alexandria/kbb-com/vehicles/listings

## Pricing

$0.00873 per call.

## Limits

- 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 | Allowed | 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 `exterior_color` (e.g. white matches Snowflake White Pearl Mica). |

## Example

```bash
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>"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=kbb-com%2Fvehicles%2Flistings

## Common questions

### Kelley Blue Book · Listings

**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.

