docs / cars-com

Cars.com

US car listings with prices, specs and dealers.

base /cars-com/v14 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 →

post/cars-com/v1/dealer1 credit

Dealer profile by cars.com dealer id/URL: name, star rating, review count, phone, address, hours, recent customer reviews + a sample of the dealer's featured inventory

Parameter		Allowed / range	Description
id	optional	—	Cars.com dealer id (the number in a /dealers/<id>/ URL). Provide id OR url.
url	optional	—	Full dealer-page URL (alternative to id; id parsed from /dealers/<id>/).

Try in playground →

post/cars-com/v1/reviews1 credit

Vehicle research/reviews by make+model (+year): consumer star rating & count, the cars.com expert review take, combined MPG, seating, body style, drivetrain, and starting price

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.
year	optional	1990–2100	Model year — yields the RICHEST data (consumer rating + expert review + MPG/specs). Omit for the model overview.

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
}