Search dealer listings for a filter set and group them by seller. At least one filter besides condition is required. Carsales returns a rotating sample of up to 30 listings per filter set and has no paging. total_results is the approximate live count and can drift by a few listings between requests. Carsales exposes the state of a listing, not the suburb. Dealer names and dealer profiles are not available, so dealers are identified by seller_id.
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.
14 optional filters available.
string
Optional
used or new.
example
string
Optional
Make name from the taxonomy endpoint, for example Toyota.
example
string
Optional
Model name from the taxonomy endpoint. Needs make.
example
string
Optional
Full state name or short code, for example Queensland or QLD.
example
string
Optional
Body style from the facets endpoint, for example Sedan.
example
string
Optional
Automatic or Manual.
example
string
Optional
Free text keyword.
running shoes
integer
Optional
Minimum model year.
10
integer
Optional
Maximum model year.
10
integer
Optional
Minimum price in AUD.
10
integer
Optional
Maximum price in AUD.
10
integer
Optional
Minimum odometer in km.
10
integer
Optional
Maximum odometer in km.
10
integer
Optional
Listings to group from the sample, 1 to 30.
10
Errors
Handle these documented responses before retrying or showing customer-facing failures.
HTTP 404
The listing, make, model or year was not found. This response is not billable.
HTTP 422
A parameter is invalid, a value is unknown, or no filter was set. This response is not billable.
HTTP 502
The upstream answer changed shape and could not be read. This response is not billable.
HTTP 503
The upstream refused the request or is unavailable. 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.