docs / cars-com

Cars.com

US car listings with prices, specs and dealers.

base /cars-com/v12 endpoints

post/cars-com/v1/search1 credit

US vehicle listings (make/model/zip/radius + price/year/mileage/stock_type, paginated); every card carries VIN

Parameter		Allowed / range	Description
make	optional	—	Vehicle make (e.g. 'Honda'). Accepts a single value or a list.
model	optional	—	Vehicle model (e.g. 'Accord'). Use with make; a single value or list.
zip	optional	—	US ZIP code to center the search; omit to search nationwide.
radius = 30	optional	0–	Search radius in miles around the ZIP (default 30; ignored if no zip).
price_min	optional	0–	Minimum list price in USD.
price_max	optional	0–	Maximum list price in USD.
year_min	optional	1900–2100	Earliest model year.
year_max	optional	1900–2100	Latest model year.
mileage_max	optional	0–	Maximum mileage (miles).
stock_type = all	optional	all · used · new · cpo	New / used / certified-pre-owned filter (unknown values fall back to 'all').
page = 1	optional	1–	Results page (paginated). Default 1.
sort	optional	best_match_desc · list_price · list_price_desc · mileage · year_desc · year · distance	Result ordering. Common cars.com sort keys shown; other keys are passed through as-is.
keyword	optional	—	Free-text keyword filter (matched against listing text).

Try in playground →

post/cars-com/v1/listing_detail1 credit

Full vehicle (VIN, spec, engine/transmission/mpg, stock#, history flags [recall/accidents/owner/title], dealer, features, seller_notes, photos)

Parameter		Allowed / range	Description
id	optional	—	Cars.com listing id (from a search listing or a /vehicledetail/<id> URL). Provide id OR url.
url	optional	—	Full vehicle-detail URL (alternative to id; id parsed from /vehicledetail/<id>).

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/cars-com/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"make":"Honda","model":"Accord","zip":"60601","stock_type":"used"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}