Spiral gives your agent every tool with one account. Browse the tools →

AlexandriaE-commerceAvailable now

Kelley Blue Book · Listings

kbb-com/vehicles/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.

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

FieldKindDefaultDescription
zip requiredtext—

Five-digit US ZIP code at the centre of the search. Pattern: ^[0-9]{5}$.

make requiredtext—

kbb.com make slug, e.g. toyota, honda, ford, mercedes-benz.

pagenumber
1 to 40
1

Result page; 25 listings per page.

sortone 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).

trimtext—

Trim name as shown in listings (e.g. SE, XLE, Sport Touring). Requires model.

modeltext—

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_maxnumber
1981 to 2030
—

Newest model year to include, inclusive; must not be below year_min.

year_minnumber
1981 to 2030
—

Oldest model year to include, inclusive.

price_maxnumber
0 to …
—

Highest advertised price to include, in whole US dollars; must not be below price_min.

price_minnumber
0 to …
—

Lowest advertised price to include, in whole US dollars.

drive_typeone 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_maxnumber
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_typeone of
used, new, certified, all
used

Inventory to search: used, new, certified pre-owned, or all three. Defaults to used.

radius_milesone 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_colorone 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).

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.