Return the Cars.com deal rating for a page of listings in a ZIP area. Each evaluation carries the listing ID, the price badge, the predicted price, the list price in USD, mileage in miles, city and highway MPG, the model year, make and model, and the dealer. Use it to rank or filter listings by how good the deal is.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
6 optional filters available.
string
Optional
US ZIP code for the evaluation area.
example
integer
Optional
Search radius in miles.
10
boolean
Optional
Only listings with no reported accidents.
true
string
Optional
BEST_MATCH_DESC, DISTANCE, MILEAGE, MILEAGE_DESC, YEAR, YEAR_DESC, LISTED_AT_DESC or LIST_PRICE_DESC.
relevance
integer
Optional
Result page, starting at 1.
1
integer
Optional
Evaluations per page, 1 to 100.
10
Errors
Handle these documented responses before retrying or showing customer-facing failures.
HTTP 422
A public parameter is invalid or an unsupported filter was sent. This response is not billable.
HTTP 503
Cars.com did not return usable data for this request. This response is not billable.
Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.