carsales.com APIcarsales.com ↗
Access carsales.com.au listings, detailed specs, makes, and models via API. Filter by make, model, state, and price to retrieve Australian used and new car data.
curl -X GET 'https://api.parse.bot/scraper/48575139-8ff3-4d8f-8bea-01d39a790116/search_cars?make=toyota' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for car listings on carsales.com.au with optional filters for make, model, state, and price range. Returns paginated results with listing summaries.
| Param | Type | Description |
|---|---|---|
| make | string | Car make slug (e.g. toyota, ford, mazda) |
| model | string | Car model slug (e.g. corolla, hilux). Requires make to be set. |
| state | string | Australian state slug (vic, nsw, qld, sa, wa, tas, nt, act). Requires make and model to be set. |
| offset | string | Results offset for pagination. |
| max_price | string | Maximum price filter (e.g. 50000). |
| min_price | string | Minimum price filter (e.g. 20000). |
{
"type": "object",
"fields": {
"listings": "array of listing objects with id, slug, title, price, make, model, year, state, mileage, body_type, transmission, engine, location, images",
"total_count": "integer total number of matching listings"
},
"sample": {
"data": {
"listings": [
{
"id": "OAG-AD-25643832",
"make": "Toyota",
"slug": "2021-toyota-hilux-sr-auto-4x4-double-cab",
"year": "2021",
"model": "Hilux",
"price": "$47,990",
"state": "QLD",
"title": "2021 Toyota Hilux SR Auto 4x4",
"engine": "4cyl 2.8L T Diesel",
"images": [],
"mileage": "103,746 km",
"location": "QLD",
"body_type": "Cab Chassis",
"transmission": "Automatic"
}
],
"total_count": 26589
},
"status": "success"
}
}About the carsales.com API
This API gives programmatic access to carsales.com.au across 4 endpoints, covering listing search, full listing details, makes, and models. The search_cars endpoint returns paginated summaries including price, mileage, transmission, body type, and location, while get_listing_details exposes complete specifications and seller descriptions for any individual listing identified by its slug and ad ID.
Search and Filter Listings
The search_cars endpoint accepts optional filters for make, model, state (Australian state slugs such as vic, nsw, or qld), min_price, max_price, and an offset for pagination. Each result in the listings array includes fields like id, slug, title, price, year, mileage, body_type, transmission, engine, and location. The total_count field tells you how many matching listings exist, which is useful for building paginated result sets. Note that model requires make to be set, and state requires both make and model.
Listing Details and Specifications
The get_listing_details endpoint takes a slug and ad_id — both returned by search_cars — and returns the full listing record. This includes an images array of URLs, a description string from the seller, and a specifications object covering engine, transmission, dimensions, fuel type, safety ratings, and features. This is the endpoint to use when you need the complete vehicle profile rather than the summary fields from search.
Makes and Models Reference
Two catalog endpoints support browsable navigation. get_makes returns a flat array of {name, slug} objects for every car make listed on the site — no parameters required. get_models_by_make accepts a make slug and returns a matching models array in the same {name, slug} shape, plus the queried make slug echoed back. These are useful for populating dropdowns, validating slugs before search calls, or building a full inventory of what makes and models are currently represented on carsales.com.au.
- Build a used car price tracker that monitors listings by make, model, and state over time using
search_carsfilters. - Aggregate mileage and price data across makes to produce depreciation or value-for-money comparisons.
- Populate an automotive comparison tool using full specification objects from
get_listing_details. - Create a lead-generation feed for car dealers by scanning new listings in a specific state or price band.
- Build a car-shopping app with make and model dropdowns populated dynamically from
get_makesandget_models_by_make. - Monitor inventory levels for specific models by tracking
total_countfromsearch_carsover time. - Extract seller description text and images from
get_listing_detailsto feed a vehicle content database.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does carsales.com.au have an official developer API?+
How does pagination work in `search_cars`?+
search_cars endpoint returns a total_count integer alongside the listings array. Use the offset parameter to step through pages — for example, if a page returns 20 results, pass offset=20 to retrieve the next 20. The total_count value tells you when you've exhausted all matching results.Can I filter listings by body type, transmission, or mileage?+
search_cars supports filtering by make, model, state, min_price, and max_price. Body type, transmission, mileage, and year filters are not exposed as parameters, though those fields are present in the response. You can fork this API on Parse and revise it to add those filter parameters.Does the API cover dealer profiles or seller contact details?+
location and a seller description string from get_listing_details, but phone numbers, email addresses, and dealer pages are not part of the response shape. You can fork this API on Parse and revise it to add a dealer details endpoint if that data is accessible from the source.Is coverage limited to Australia?+
vic, nsw, qld, etc.), and pricing are Australia-specific. The API does not cover carsales sister sites in other countries such as South Korea or Brazil.