Search Carsales by make, model, year, price, odometer, body style, state, transmission, seller type and keyword. 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 and no sort. 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. Sorting is not available: Carsales cannot sort, so the sort parameter is accepted but no sort is applied and the sort object says so. Paging is not available either: has_more is always null. Split a large search with price, year, odometer, state or model filters until pagination.covers_all_results is true. Prices carry a price_basis. Sale status is only on the listing endpoint. Listings in another state than the state filter are dropped and counted in rows_dropped_state_mismatch. Dealer profiles are not available.
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.
16 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
Dealer or Private.
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
string
Optional
price_asc, price_desc, year_desc or odometer_asc. Carsales cannot sort: the value is only echoed in the sort object and no sort is applied.
relevance
integer
Optional
Listings to return 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.