autotrader.com.au APIautotrader.com.au ↗
Search and retrieve car listings from AutoTrader Australia. Filter by make, model, price, location, and more. Access specs, pricing, dealer info, and photos.
curl -X GET 'https://api.parse.bot/scraper/a1d5a83e-deca-4025-883c-34aca18c40d8/search_listings?make=Toyota&page=1&model=Corolla&paginate=5' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for car listings with various filters. Returns a paginated list of listings sorted by the specified criteria. Each listing includes full vehicle details, pricing, photos, dealer info, and location.
| Param | Type | Description |
|---|---|---|
| make | string | Car make to filter by (e.g. 'Toyota', 'Ford', 'Mazda'). Values available from get_available_makes endpoint. |
| page | integer | Page number for pagination. |
| model | string | Car model to filter by (e.g. 'Corolla', 'RAV4'). Values available from get_models_for_make endpoint. |
| radius | integer | Search radius in km from postcode location. |
| sortBy | string | Field to sort results by: 'price', 'year', 'odometer'. |
| orderBy | string | Sort order: 'asc' or 'desc'. |
| priceTo | integer | Maximum price filter. |
| location | string | Australian state abbreviation (e.g. 'NSW', 'VIC', 'QLD'). |
| paginate | integer | Number of results per page. |
| postcode | string | Australian postcode for location-based search. |
| condition | string | Vehicle condition filter: 'Used' or 'New'. |
| priceFrom | integer | Minimum price filter. |
{
"type": "object",
"fields": {
"data": "array of listing objects, each containing _source with full vehicle details including id, make, model, price, vehicle specs, dealer info, photos, and location",
"total": "integer, total number of matching listings",
"last_page": "integer, total number of pages",
"current_page": "integer, current page number"
},
"sample": {
"data": {
"data": [
{
"sort": [
800
],
"_score": null,
"_source": {
"id": 15085852,
"make": "Toyota",
"model": "RAV4",
"price": {
"driveaway_price": 0,
"advertised_price": 800
},
"dealer": {
"city": "Slacks Creek",
"state": "QLD",
"trading_name": "King of the Cheapies Slacks Creek"
},
"vehicle": {
"body_type": "Wagon",
"fuel_type": "Unleaded",
"engine_size": "2.00",
"transmission_type": "Manual"
},
"odometer": 406000,
"condition": "Used",
"manu_year": 1998,
"location_city": "Slacks Creek",
"location_state": "QLD"
}
}
],
"total": 2225,
"last_page": 445,
"current_page": 1
},
"status": "success"
}
}About the autotrader.com.au API
The AutoTrader Australia API exposes 4 endpoints for searching and retrieving vehicle listings from autotrader.com.au. The search_listings endpoint supports filters for make, model, price ceiling, Australian state, and proximity radius, returning paginated results with full vehicle specs and dealer details. Companion endpoints let you fetch all available makes, drill into models for a specific make, and pull complete listing detail by ID.
Search and Filter Listings
The search_listings endpoint accepts up to eight optional parameters including make, model, priceTo, location (Australian state abbreviation such as NSW or VIC), and radius in kilometres from a postcode. Results can be sorted by price, year, or odometer in ascending or descending order. Each response returns a data array of listing objects alongside total, last_page, and current_page fields for pagination.
Listing Detail and Vehicle Specifications
The get_listing_detail endpoint accepts a numeric listing_id — available from data[*]._source.id in search results — and returns a single listing record. The response includes a structured price object with both advertised_price and driveaway_price, a dealer object with trading_name, city, state, and phone, a photos array with image_path values, and a vehicle object covering body_type, transmission_type, fuel_type, engine_size, seats, doors, and more. The description field carries the seller's free-text vehicle description.
Make and Model Lookup
Before constructing a search query, get_available_makes returns every make currently represented in the listing index along with a doc_count showing how many listings exist for each. Once you have a make, get_models_for_make returns the model breakdown for that manufacturer in the same key / doc_count format. These two endpoints are the canonical source for valid make and model values accepted by search_listings.
- Build a used-car price tracker by polling
search_listingswith a fixedmakeandmodeland recordingadvertised_priceover time. - Power a dealer inventory aggregator by filtering
search_listingsonlocationand extractingdealer.trading_nameanddealer.phone. - Create a fuel-type comparison tool using the
vehicle.fuel_typefield returned byget_listing_detail. - Generate market-availability reports by iterating
get_available_makesand mapping each make'sdoc_count. - Show nearby listings in a geo-aware app by passing a postcode with a
radiusparameter tosearch_listings. - Display a full vehicle photo gallery by rendering the
photosarray fromget_listing_detailin a front-end carousel. - Identify underpriced listings by sorting
search_listingsresults byprice ascand comparingadvertised_pricetodriveaway_price.
| 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 AutoTrader Australia offer an official developer API?+
What does `search_listings` return beyond basic make and model?+
data array includes the full _source object for the listing, which covers vehicle specifications, pricing, dealer information, and location. The response envelope also includes total (matching listing count), last_page, and current_page to support pagination across large result sets.Are motorcycle, truck, or other non-car vehicle listings available?+
get_available_makes and get_models_for_make reflect the passenger and light-vehicle inventory. You can fork the API on Parse and revise it to add endpoints targeting other vehicle categories.Is seller contact information exposed for private listings, not just dealer listings?+
dealer object in get_listing_detail returns trading_name, city, state, and phone fields. Contact details for private-seller listings are not currently exposed separately. You can fork the API on Parse and revise it to add a dedicated private-seller contact endpoint.How should I get valid values for the `make` and `model` parameters in `search_listings`?+
get_available_makes first to retrieve the current list of make names and their listing counts, then pass the desired key value as the make parameter. To get valid model strings, call get_models_for_make with that make name. Using values from these endpoints avoids empty result sets caused by spelling variations.