Search Cars.com new and used vehicle listings. Filter by ZIP code and radius, make and model slugs, stock type, model year range, fuel and transmission slugs, and seller type. Results carry numeric USD prices, mileage in miles, the Cars.com price badge, the predicted price, the model year, make, model, trim, body style, fuel, transmission, drivetrain, colours, dealer, stock number, and the certified-preowned flag. Page through with page and page_size and read has_more from the live total page count.
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.
13 optional filters available.
string
Optional
US ZIP code for the search area.
example
integer
Optional
Search radius in miles.
10
array
Optional
Repeatable make slug from the taxonomy endpoint, e.g. toyota.
["example"]
array
Optional
Repeatable model slug from the taxonomy endpoint, e.g. toyota-camry.
["example"]
string
Optional
all, used, new or cpo.
example
integer
Optional
Minimum model year.
10
integer
Optional
Maximum model year.
10
array
Optional
Repeatable fuel slug, e.g. electric.
["example"]
array
Optional
Repeatable transmission slug, e.g. manual.
["example"]
array
Optional
Repeatable: dealership, private_seller or online_seller.
["example"]
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
Listings 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.