Reef AI: ask for any data. Try it
Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the carsales API page →
docs / carsales

carsales

Australia's largest car marketplace as JSON: car search with every carsales filter and its counts, full listings with the drive-away breakdown, dealer stock and model research.

base /carsales/v18 endpoints
post/carsales/v1/listing2 credits

One car in full: price as printed with its label (Drive away / Excl. Govt. Charges / Indicative drive away), the on-road cost breakdown (stamp duty, transfer, registration, CTP, dealer delivery) for the listing's state, carsales' price badge, odometer, every spec and feature group, colours, build / compliance date, rego expiry, VIN picture, description, all photos and videos, location and the seller (dealer name, phone, car code, address, rating, member since, stock count).

ParameterAllowed / rangeDescription
listing_idrequired—Listing id from a search row (OAG-AD-… dealer, SSE-AD-… private, SHRM-AD-… new car to order) or a carsales.com.au listing URL.
Try in playground →
post/carsales/v1/seller2 credits

A dealer's or private seller's cars on carsales (every listing, paged like `search`, same filters and sorts) and, on page 1, the seller profile read from their first listing: dealer name, phone, car code, address, Google / review rating, member since, current listing count.

ParameterAllowed / rangeDescription
seller_idrequired—The seller_id a search row or listing returns (AGC-SELLER-43607, SSE-SELLER-21115837).
include_profile = trueoptional—Read the seller profile from the first listing (page 1 only; one extra request).
queryoptional—Keyword searched in the whole listing, as typed in the site's keyword box (e.g. 'sunroof', 'towbar', 'one owner').
makeoptional—Make as carsales spells it (e.g. Toyota, Mercedes-Benz). `makes` lists all of them with counts.
modeloptional—Model of that make (e.g. Corolla, Landcruiser Prado). `models` lists them. Needs `make`.
badgeoptional—Badge / trim of that model as the site lists it (e.g. Ascent Sport Hybrid). `filters` with filter=badge lists them. Needs `model`.
conditionoptionalnew · used · demo_near_new · used_onlynew · used (the site's 'Used, Demo & Near New') · demo_near_new · used_only (used without demo / near-new).
seller_typeoptionaldealer · privatedealer or private.
stateoptionalact · nsw · nt · qld · sa · tas · vic · waAustralian state or territory: act, nsw, nt, qld, sa, tas, vic, wa (full names accepted).
regionoptional—Region as carsales names it (e.g. Sydney, Melbourne, Gold Coast, Hunter Valley exc Newcastle). `filters` with filter=region and a state lists them.
locationoptional—Suburb, postcode or region (e.g. 'Parramatta', '2150', 'Parramatta NSW 2150'); resolved with the site's own lookup (`locations`). A suburb searches within `radius_km`.
radius_km = 25optional25 · 50 · 100 · 250 · 500 · 1000 · 2000 · 5000Search radius around `location` — the site's own stops: 25, 50, 100, 250, 500, 1000, 2000, 5000 (default 25).
body_typeoptionalbus · cab_chassis · convertible · coupe · hatch · light_truck · people_mover · sedan · suv · ute · van · wagonBody type: bus, cab_chassis, convertible, coupe, hatch, light_truck, people_mover, sedan, suv, ute, van, wagon. One value or several (comma-separated = any of them).
fuel_typeoptionalpetrol · diesel · hybrid · plug_in_hybrid · electric · dual_fuel · gas_onlyFuel: petrol, diesel, hybrid, plug_in_hybrid, electric, dual_fuel, gas_only. One value or several (comma-separated = any of them).
transmissionoptionalautomatic · manual · amtautomatic, manual or amt. One value or several (comma-separated = any of them).
drive_typeoptional4x4 · 4x2 · 6x2 · 6x6 · front_wheel_drive · rear_wheel_driveDrive: 4x4, 4x2, 6x2, 6x6, front_wheel_drive, rear_wheel_drive. One value or several (comma-separated = any of them).
colouroptionalbeige · black · blue · bronze · brown · burgundy · gold · green · grey · magenta · maroon · orange · pink · purple · red · silver · white · yellowExterior colour: beige, black, blue, bronze, brown, burgundy, gold, green, grey, magenta, maroon, orange, pink, purple, red, silver, white, yellow. One value or several (comma-separated = any of them).
cylindersoptional2 · 3 · 4 · 5 · 6 · 8 · 10 · 12Engine cylinders: 2, 3, 4, 5, 6, 8, 10, 12 (several = any).
doorsoptional1 · 2 · 3 · 4 · 5 · 6Doors: 1-6 (several = any).
price_minoptional0–Lowest price in AUD.
price_maxoptional0–Highest price in AUD.
year_minoptional0–Lowest model year.
year_maxoptional0–Highest model year.
odometer_minoptional0–Lowest odometer in km.
odometer_maxoptional0–Highest odometer in km.
seats_minoptional0–Lowest number of seats.
seats_maxoptional0–Highest number of seats.
engine_size_minoptional0–Lowest engine size in cc.
engine_size_maxoptional0–Highest engine size in cc.
power_minoptional0–Lowest power in kW.
power_maxoptional0–Highest power in kW.
towing_minoptional0–Lowest braked towing capacity in kg.
towing_maxoptional0–Highest braked towing capacity in kg.
ev_range_minoptional0–Lowest electric driving range in km.
ev_range_maxoptional0–Highest electric driving range in km.
battery_capacity_minoptional0–Lowest high-voltage battery capacity in kWh.
battery_capacity_maxoptional0–Highest high-voltage battery capacity in kWh.
power_to_weight_minoptional0–Lowest power-to-weight ratio in kW/t.
power_to_weight_maxoptional0–Highest power-to-weight ratio in kW/t.
price_ratingoptionalgreat · good · faircarsales' price badge: great (Great price), good (Good price), fair (Fair price). One value or several (comma-separated = any of them).
ancapoptional5_stars_only · 4_stars_or_more · 3_stars_or_more · less_than_3_starsANCAP safety rating: 5_stars_only, 4_stars_or_more, 3_stars_or_more, less_than_3_stars.
fuel_economyoptional4_or_less · 5_or_less · 7_or_less · 9_or_less · 11_or_less · 11_or_moreCombined fuel economy: 4_or_less, 5_or_less, 7_or_less, 9_or_less, 11_or_less (L/100km), 11_or_more.
inductionoptionalaspirated · turbo · supercharged · turbo_supercharged · turbo_electric_compressor · twin_turbo_electric_compressor · not_applicableInduction: aspirated, turbo, supercharged, turbo_supercharged, turbo_electric_compressor, twin_turbo_electric_compressor, not_applicable. One value or several (comma-separated = any of them).
brand_originoptionalaustralia · austria · china · czech_republic · france · germany · great_britain · india · italy · japan · malaysia · russia · south_korea · spain · sweden · united_statesCountry the brand comes from (e.g. japan, germany, south_korea, china, australia). One value or several (comma-separated = any of them).
lifestyleoptionalfamily · first_car · green · offroad_4x4 · performance · prestige · tradie · uniqueThe site's lifestyle groups: family, first_car, green, offroad_4x4, performance, prestige, tradie, unique. One value or several (comma-separated = any of them).
ads_withoptionalphotos · prices · videos · roadworthy_certificates · car_history_snapshot · manufacturer_certifications · redbook_inspectionsOnly listings with: photos, prices, videos, roadworthy_certificates, car_history_snapshot, manufacturer_certifications, redbook_inspections. One value or several (comma-separated = any of them).
certifiedoptionalcertified · inspectedcertified (manufacturer certified) or inspected (RedBook inspected). One value or several (comma-separated = any of them).
charge_socketoptionalccs2 · chademo · type_1 · type_2EV charge socket: ccs2, chademo, type_1, type_2. One value or several (comma-separated = any of them).
buyers_guideoptionaltop_pick · top_5carsales buyer's guide: top_pick or top_5.
best_foroptional—The site's 'Best for' tag as it prints it (e.g. Camping, Big Boot, Cheap To Run, Dog Friendly; `filters` with filter=best_for lists all 83).
featureoptional—A feature from the site's 'Features A-Z' list (e.g. Apple CarPlay, Sunroof, Tow Bar, Heated Seats; `filters` with filter=feature lists them).
engine_descriptionoptional—The site's engine code (e.g. 2.0t, 3.0dt, 1.8i; `filters` with filter=engine_description lists them).
p_plate_stateoptionalact · nsw · nt · qld · sa · tas · vic · waOnly cars P-plate approved in this state (act, nsw, nt, qld, sa, tas, vic, wa).
id_verifiedoptional—Only ID-verified private sellers.
dealer_financeoptional—Only dealer cars with finance available.
special_offersoptional—Only cars with special offers.
trade_inoptional—Only dealers that accept a carsales trade-in.
sort = featuredoptionalfeatured · price_asc · price_desc · odometer_asc · odometer_desc · year_desc · year_asc · acceleration · power · battery_capacity · ev_range · trade_in_bonusOrder: featured (the site's default), price_asc, price_desc, odometer_asc, odometer_desc, year_desc, year_asc, acceleration, power, battery_capacity, ev_range, trade_in_bonus. ('Recently updated' needs a login on the site — not offered.)
page = 1optional1–20Page 1-20, 22 cars each (the site serves 20 pages per search). With `cursor` the next page costs one request; a cold jump to page N walks N pages.
cursoroptional—The `next_cursor` of the previous answer: fetches the next page of the same search in one request (the filters of the first call are kept; other filters you send are ignored).
Try in playground →
post/carsales/v1/filters2 credits

The values one filter can take for a search, each with the number of cars carsales shows for it (e.g. body types of used Toyotas in NSW, models of a make, badges of a model, regions of a state); range filters (year, price, km, …) return the site's stops with counts where it prints them. `value` is what `search` accepts.

ParameterAllowed / rangeDescription
filterrequiredmake · model · badge · state · region · condition · condition_subtype · seller_type · body_type · fuel_type · transmission · drive_type · colour · cylinders · doors · price_rating · dealer_finance · special_offers · trade_in · buyers_guide · brand_origin · charge_socket · fuel_economy · induction · p_plate_state · engine_description · id_verified · lifestyle · best_for · ancap · feature · certified · ads_with · year · price · odometer · seats · engine_size · power · towing · ev_range · battery_capacity · power_to_weightWhich filter: make, model, badge, state, region, condition, condition_subtype, seller_type, body_type, fuel_type, transmission, drive_type, colour, cylinders, doors, price_rating, dealer_finance, special_offers, trade_in, buyers_guide, brand_origin, charge_socket, fuel_economy, induction, p_plate_state, engine_description, id_verified, lifestyle, best_for, ancap, feature, certified, ads_with, year, price, odometer, seats, engine_size, power, towing, ev_range, battery_capacity, power_to_weight.
queryoptional—Keyword searched in the whole listing, as typed in the site's keyword box (e.g. 'sunroof', 'towbar', 'one owner').
makeoptional—Make as carsales spells it (e.g. Toyota, Mercedes-Benz). `makes` lists all of them with counts.
modeloptional—Model of that make (e.g. Corolla, Landcruiser Prado). `models` lists them. Needs `make`.
badgeoptional—Badge / trim of that model as the site lists it (e.g. Ascent Sport Hybrid). `filters` with filter=badge lists them. Needs `model`.
conditionoptionalnew · used · demo_near_new · used_onlynew · used (the site's 'Used, Demo & Near New') · demo_near_new · used_only (used without demo / near-new).
seller_typeoptionaldealer · privatedealer or private.
stateoptionalact · nsw · nt · qld · sa · tas · vic · waAustralian state or territory: act, nsw, nt, qld, sa, tas, vic, wa (full names accepted).
regionoptional—Region as carsales names it (e.g. Sydney, Melbourne, Gold Coast, Hunter Valley exc Newcastle). `filters` with filter=region and a state lists them.
locationoptional—Suburb, postcode or region (e.g. 'Parramatta', '2150', 'Parramatta NSW 2150'); resolved with the site's own lookup (`locations`). A suburb searches within `radius_km`.
radius_km = 25optional25 · 50 · 100 · 250 · 500 · 1000 · 2000 · 5000Search radius around `location` — the site's own stops: 25, 50, 100, 250, 500, 1000, 2000, 5000 (default 25).
body_typeoptionalbus · cab_chassis · convertible · coupe · hatch · light_truck · people_mover · sedan · suv · ute · van · wagonBody type: bus, cab_chassis, convertible, coupe, hatch, light_truck, people_mover, sedan, suv, ute, van, wagon. One value or several (comma-separated = any of them).
fuel_typeoptionalpetrol · diesel · hybrid · plug_in_hybrid · electric · dual_fuel · gas_onlyFuel: petrol, diesel, hybrid, plug_in_hybrid, electric, dual_fuel, gas_only. One value or several (comma-separated = any of them).
transmissionoptionalautomatic · manual · amtautomatic, manual or amt. One value or several (comma-separated = any of them).
drive_typeoptional4x4 · 4x2 · 6x2 · 6x6 · front_wheel_drive · rear_wheel_driveDrive: 4x4, 4x2, 6x2, 6x6, front_wheel_drive, rear_wheel_drive. One value or several (comma-separated = any of them).
colouroptionalbeige · black · blue · bronze · brown · burgundy · gold · green · grey · magenta · maroon · orange · pink · purple · red · silver · white · yellowExterior colour: beige, black, blue, bronze, brown, burgundy, gold, green, grey, magenta, maroon, orange, pink, purple, red, silver, white, yellow. One value or several (comma-separated = any of them).
cylindersoptional2 · 3 · 4 · 5 · 6 · 8 · 10 · 12Engine cylinders: 2, 3, 4, 5, 6, 8, 10, 12 (several = any).
doorsoptional1 · 2 · 3 · 4 · 5 · 6Doors: 1-6 (several = any).
price_minoptional0–Lowest price in AUD.
price_maxoptional0–Highest price in AUD.
year_minoptional0–Lowest model year.
year_maxoptional0–Highest model year.
odometer_minoptional0–Lowest odometer in km.
odometer_maxoptional0–Highest odometer in km.
seats_minoptional0–Lowest number of seats.
seats_maxoptional0–Highest number of seats.
engine_size_minoptional0–Lowest engine size in cc.
engine_size_maxoptional0–Highest engine size in cc.
power_minoptional0–Lowest power in kW.
power_maxoptional0–Highest power in kW.
towing_minoptional0–Lowest braked towing capacity in kg.
towing_maxoptional0–Highest braked towing capacity in kg.
ev_range_minoptional0–Lowest electric driving range in km.
ev_range_maxoptional0–Highest electric driving range in km.
battery_capacity_minoptional0–Lowest high-voltage battery capacity in kWh.
battery_capacity_maxoptional0–Highest high-voltage battery capacity in kWh.
power_to_weight_minoptional0–Lowest power-to-weight ratio in kW/t.
power_to_weight_maxoptional0–Highest power-to-weight ratio in kW/t.
price_ratingoptionalgreat · good · faircarsales' price badge: great (Great price), good (Good price), fair (Fair price). One value or several (comma-separated = any of them).
ancapoptional5_stars_only · 4_stars_or_more · 3_stars_or_more · less_than_3_starsANCAP safety rating: 5_stars_only, 4_stars_or_more, 3_stars_or_more, less_than_3_stars.
fuel_economyoptional4_or_less · 5_or_less · 7_or_less · 9_or_less · 11_or_less · 11_or_moreCombined fuel economy: 4_or_less, 5_or_less, 7_or_less, 9_or_less, 11_or_less (L/100km), 11_or_more.
inductionoptionalaspirated · turbo · supercharged · turbo_supercharged · turbo_electric_compressor · twin_turbo_electric_compressor · not_applicableInduction: aspirated, turbo, supercharged, turbo_supercharged, turbo_electric_compressor, twin_turbo_electric_compressor, not_applicable. One value or several (comma-separated = any of them).
brand_originoptionalaustralia · austria · china · czech_republic · france · germany · great_britain · india · italy · japan · malaysia · russia · south_korea · spain · sweden · united_statesCountry the brand comes from (e.g. japan, germany, south_korea, china, australia). One value or several (comma-separated = any of them).
lifestyleoptionalfamily · first_car · green · offroad_4x4 · performance · prestige · tradie · uniqueThe site's lifestyle groups: family, first_car, green, offroad_4x4, performance, prestige, tradie, unique. One value or several (comma-separated = any of them).
ads_withoptionalphotos · prices · videos · roadworthy_certificates · car_history_snapshot · manufacturer_certifications · redbook_inspectionsOnly listings with: photos, prices, videos, roadworthy_certificates, car_history_snapshot, manufacturer_certifications, redbook_inspections. One value or several (comma-separated = any of them).
certifiedoptionalcertified · inspectedcertified (manufacturer certified) or inspected (RedBook inspected). One value or several (comma-separated = any of them).
charge_socketoptionalccs2 · chademo · type_1 · type_2EV charge socket: ccs2, chademo, type_1, type_2. One value or several (comma-separated = any of them).
buyers_guideoptionaltop_pick · top_5carsales buyer's guide: top_pick or top_5.
best_foroptional—The site's 'Best for' tag as it prints it (e.g. Camping, Big Boot, Cheap To Run, Dog Friendly; `filters` with filter=best_for lists all 83).
featureoptional—A feature from the site's 'Features A-Z' list (e.g. Apple CarPlay, Sunroof, Tow Bar, Heated Seats; `filters` with filter=feature lists them).
engine_descriptionoptional—The site's engine code (e.g. 2.0t, 3.0dt, 1.8i; `filters` with filter=engine_description lists them).
p_plate_stateoptionalact · nsw · nt · qld · sa · tas · vic · waOnly cars P-plate approved in this state (act, nsw, nt, qld, sa, tas, vic, wa).
id_verifiedoptional—Only ID-verified private sellers.
dealer_financeoptional—Only dealer cars with finance available.
special_offersoptional—Only cars with special offers.
trade_inoptional—Only dealers that accept a carsales trade-in.
seller_idoptional—Only this seller's cars: the seller_id a row returns (AGC-SELLER-… dealer, SSE-SELLER-… private).
Try in playground →
post/carsales/v1/makes2 credits

Every make on carsales.com.au with its number of cars for sale (optionally only new / used, a state or a seller type).

ParameterAllowed / rangeDescription
conditionoptionalnew · used · demo_near_new · used_onlynew · used (the site's 'Used, Demo & Near New') · demo_near_new · used_only (used without demo / near-new).
stateoptionalact · nsw · nt · qld · sa · tas · vic · waAustralian state or territory: act, nsw, nt, qld, sa, tas, vic, wa (full names accepted).
seller_typeoptionaldealer · privatedealer or private.
Try in playground →
post/carsales/v1/models2 credits

Every model of a make with its number of cars for sale (optionally only new / used, a state or a seller type).

ParameterAllowed / rangeDescription
makerequired—Make, e.g. Toyota (see `makes`).
conditionoptionalnew · used · demo_near_new · used_onlynew · used (the site's 'Used, Demo & Near New') · demo_near_new · used_only (used without demo / near-new).
stateoptionalact · nsw · nt · qld · sa · tas · vic · waAustralian state or territory: act, nsw, nt, qld, sa, tas, vic, wa (full names accepted).
seller_typeoptionaldealer · privatedealer or private.
Try in playground →
post/carsales/v1/locations1 credit

carsales' own suburb / postcode / region lookup — the places `search` accepts in `location`, with state, postcode and region.

ParameterAllowed / rangeDescription
queryrequired—Suburb, postcode or region text (e.g. 'Parramatta', '3000', 'Gold Coast').
Try in playground →
post/carsales/v1/research2 credits

carsales' research page of a model (optionally one model year): indicative price range, body / fuel / seat options, cars for sale count, highlights, service interval, warranty, every badge with its price range and popular features, the price range of every model year, FAQ and the lead expert review with its score.

ParameterAllowed / rangeDescription
makerequired—Make, e.g. Toyota.
modelrequired—Model, e.g. Corolla.
yearoptional1950–2100Model year, e.g. 2020 (default: the current one).
Try in playground →
Built for volume
5M+ requests a day

Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.

Missing a source?
We build it

Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.

Support
2 minute median reply

Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.

One key, one balance
Every API included

No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.

Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.