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

AlexandriaE-commerceAvailable now

CARFAX · Search listings

carfax-com/vehicles/search_listings

Get product, price and seller data with CARFAX · Search listings from Alexandria through one Spiral API key. Finding used or new cars for sale near a US ZIP or nationwide, filtering for clean-history or 1-owner cars, comparing prices against Carfax's value, or listing a dealer's inventory. Chain vin into get_listing for price history, features and dealer comments. 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
ziptext—

US ZIP the radius is centred on. Omit for a nationwide search. A ZIP Carfax cannot resolve is invalid_input. Pattern: ^[0-9]{5}$.

maketext—

Make name as Carfax spells it, e.g. Honda, Mercedes-Benz, Land Rover. An unknown make returns no results.

pagenumber
1 to 50
—

1-based page of 25; Carfax serves at most 50 pages.

sortone of
best, price_asc, price_desc, mileage_asc, mileage_desc, year_desc, year_asc
—

Default best (Carfax's best match).

modeltext—

Model name, e.g. Civic, F-150, Grand Cherokee. Needs make.

max_yearnumber
1900 to 2100
—

max_year

min_yearnumber
1900 to 2100
—

min_year

certifiedtrue or false—

Only certified pre-owned.

conditionone of
used, new, any
—

Default used.

dealer_idtext—

Carfax dealer id (dealer.id from a listing) to list one dealer's inventory; use with condition any for its full stock. Pattern: ^[A-Z0-9]{6,16}$.

max_pricenumber
0 to …
—

USD.

min_pricenumber
0 to …
—

USD.

one_ownertrue or false—

Only Carfax 1-Owner vehicles.

max_mileagenumber
0 to …
—

max_mileage

min_mileagenumber
0 to …
—

min_mileage

no_accidentstrue or false—

Only vehicles with no accident or damage reported to Carfax.

personal_usetrue or false—

Only personal-use vehicles.

radius_milesone of
10, 25, 50, 75, 100, 150, 200, 250, 500
—

Radius around zip; default 50. Needs zip.

service_recordstrue or false—

Only vehicles with service records.

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": "carfax-com/vehicles/search_listings",
    "input": {
      "zip": "<zip>"
    }
  }'

Frequently asked questions

How much does CARFAX · Search 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 CARFAX · Search listings through an API?

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "carfax-com/vehicles/search_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 CARFAX · Search listings?

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

Can my AI agent use CARFAX · Search listings?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.