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.
/carsales/v1/search2 creditsCars for sale on carsales.com.au with every filter the site offers (make / model / badge, new / used / demo, dealer / private, state / region / suburb + radius, price, year, km, body, fuel, transmission, drive, colour, cylinders, doors, seats, engine size, power, towing, EV range and battery, price badge, ANCAP, features, lifestyle, …): 22 cars per page with price as printed (drive-away or excl. government charges), km, engine, price badge, seller id and type, state and photos; the site's total, 20 pages at most per search, `next_cursor` for the next page.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | optional | — | Keyword searched in the whole listing, as typed in the site's keyword box (e.g. 'sunroof', 'towbar', 'one owner'). |
| make | optional | — | Make as carsales spells it (e.g. Toyota, Mercedes-Benz). `makes` lists all of them with counts. |
| model | optional | — | Model of that make (e.g. Corolla, Landcruiser Prado). `models` lists them. Needs `make`. |
| badge | optional | — | Badge / trim of that model as the site lists it (e.g. Ascent Sport Hybrid). `filters` with filter=badge lists them. Needs `model`. |
| condition | optional | new · used · demo_near_new · used_only | new · used (the site's 'Used, Demo & Near New') · demo_near_new · used_only (used without demo / near-new). |
| seller_type | optional | dealer · private | dealer or private. |
| state | optional | act · nsw · nt · qld · sa · tas · vic · wa | Australian state or territory: act, nsw, nt, qld, sa, tas, vic, wa (full names accepted). |
| region | optional | — | Region as carsales names it (e.g. Sydney, Melbourne, Gold Coast, Hunter Valley exc Newcastle). `filters` with filter=region and a state lists them. |
| location | optional | — | 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 = 25 | optional | 25 · 50 · 100 · 250 · 500 · 1000 · 2000 · 5000 | Search radius around `location` — the site's own stops: 25, 50, 100, 250, 500, 1000, 2000, 5000 (default 25). |
| body_type | optional | bus · cab_chassis · convertible · coupe · hatch · light_truck · people_mover · sedan · suv · ute · van · wagon | Body 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_type | optional | petrol · diesel · hybrid · plug_in_hybrid · electric · dual_fuel · gas_only | Fuel: petrol, diesel, hybrid, plug_in_hybrid, electric, dual_fuel, gas_only. One value or several (comma-separated = any of them). |
| transmission | optional | automatic · manual · amt | automatic, manual or amt. One value or several (comma-separated = any of them). |
| drive_type | optional | 4x4 · 4x2 · 6x2 · 6x6 · front_wheel_drive · rear_wheel_drive | Drive: 4x4, 4x2, 6x2, 6x6, front_wheel_drive, rear_wheel_drive. One value or several (comma-separated = any of them). |
| colour | optional | beige · black · blue · bronze · brown · burgundy · gold · green · grey · magenta · maroon · orange · pink · purple · red · silver · white · yellow | Exterior 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). |
| cylinders | optional | 2 · 3 · 4 · 5 · 6 · 8 · 10 · 12 | Engine cylinders: 2, 3, 4, 5, 6, 8, 10, 12 (several = any). |
| doors | optional | 1 · 2 · 3 · 4 · 5 · 6 | Doors: 1-6 (several = any). |
| price_min | optional | 0– | Lowest price in AUD. |
| price_max | optional | 0– | Highest price in AUD. |
| year_min | optional | 0– | Lowest model year. |
| year_max | optional | 0– | Highest model year. |
| odometer_min | optional | 0– | Lowest odometer in km. |
| odometer_max | optional | 0– | Highest odometer in km. |
| seats_min | optional | 0– | Lowest number of seats. |
| seats_max | optional | 0– | Highest number of seats. |
| engine_size_min | optional | 0– | Lowest engine size in cc. |
| engine_size_max | optional | 0– | Highest engine size in cc. |
| power_min | optional | 0– | Lowest power in kW. |
| power_max | optional | 0– | Highest power in kW. |
| towing_min | optional | 0– | Lowest braked towing capacity in kg. |
| towing_max | optional | 0– | Highest braked towing capacity in kg. |
| ev_range_min | optional | 0– | Lowest electric driving range in km. |
| ev_range_max | optional | 0– | Highest electric driving range in km. |
| battery_capacity_min | optional | 0– | Lowest high-voltage battery capacity in kWh. |
| battery_capacity_max | optional | 0– | Highest high-voltage battery capacity in kWh. |
| power_to_weight_min | optional | 0– | Lowest power-to-weight ratio in kW/t. |
| power_to_weight_max | optional | 0– | Highest power-to-weight ratio in kW/t. |
| price_rating | optional | great · good · fair | carsales' price badge: great (Great price), good (Good price), fair (Fair price). One value or several (comma-separated = any of them). |
| ancap | optional | 5_stars_only · 4_stars_or_more · 3_stars_or_more · less_than_3_stars | ANCAP safety rating: 5_stars_only, 4_stars_or_more, 3_stars_or_more, less_than_3_stars. |
| fuel_economy | optional | 4_or_less · 5_or_less · 7_or_less · 9_or_less · 11_or_less · 11_or_more | Combined fuel economy: 4_or_less, 5_or_less, 7_or_less, 9_or_less, 11_or_less (L/100km), 11_or_more. |
| induction | optional | aspirated · turbo · supercharged · turbo_supercharged · turbo_electric_compressor · twin_turbo_electric_compressor · not_applicable | Induction: aspirated, turbo, supercharged, turbo_supercharged, turbo_electric_compressor, twin_turbo_electric_compressor, not_applicable. One value or several (comma-separated = any of them). |
| brand_origin | optional | australia · austria · china · czech_republic · france · germany · great_britain · india · italy · japan · malaysia · russia · south_korea · spain · sweden · united_states | Country the brand comes from (e.g. japan, germany, south_korea, china, australia). One value or several (comma-separated = any of them). |
| lifestyle | optional | family · first_car · green · offroad_4x4 · performance · prestige · tradie · unique | The site's lifestyle groups: family, first_car, green, offroad_4x4, performance, prestige, tradie, unique. One value or several (comma-separated = any of them). |
| ads_with | optional | photos · prices · videos · roadworthy_certificates · car_history_snapshot · manufacturer_certifications · redbook_inspections | Only listings with: photos, prices, videos, roadworthy_certificates, car_history_snapshot, manufacturer_certifications, redbook_inspections. One value or several (comma-separated = any of them). |
| certified | optional | certified · inspected | certified (manufacturer certified) or inspected (RedBook inspected). One value or several (comma-separated = any of them). |
| charge_socket | optional | ccs2 · chademo · type_1 · type_2 | EV charge socket: ccs2, chademo, type_1, type_2. One value or several (comma-separated = any of them). |
| buyers_guide | optional | top_pick · top_5 | carsales buyer's guide: top_pick or top_5. |
| best_for | optional | — | 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). |
| feature | optional | — | 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_description | optional | — | The site's engine code (e.g. 2.0t, 3.0dt, 1.8i; `filters` with filter=engine_description lists them). |
| p_plate_state | optional | act · nsw · nt · qld · sa · tas · vic · wa | Only cars P-plate approved in this state (act, nsw, nt, qld, sa, tas, vic, wa). |
| id_verified | optional | — | Only ID-verified private sellers. |
| dealer_finance | optional | — | Only dealer cars with finance available. |
| special_offers | optional | — | Only cars with special offers. |
| trade_in | optional | — | Only dealers that accept a carsales trade-in. |
| seller_id | optional | — | Only this seller's cars: the seller_id a row returns (AGC-SELLER-… dealer, SSE-SELLER-… private). |
| sort = featured | optional | featured · price_asc · price_desc · odometer_asc · odometer_desc · year_desc · year_asc · acceleration · power · battery_capacity · ev_range · trade_in_bonus | Order: 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 = 1 | optional | 1–20 | Page 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. |
| cursor | optional | — | 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). |
/carsales/v1/listing2 creditsOne 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).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| listing_id | required | — | 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. |
/carsales/v1/seller2 creditsA 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.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| seller_id | required | — | The seller_id a search row or listing returns (AGC-SELLER-43607, SSE-SELLER-21115837). |
| include_profile = true | optional | — | Read the seller profile from the first listing (page 1 only; one extra request). |
| query | optional | — | Keyword searched in the whole listing, as typed in the site's keyword box (e.g. 'sunroof', 'towbar', 'one owner'). |
| make | optional | — | Make as carsales spells it (e.g. Toyota, Mercedes-Benz). `makes` lists all of them with counts. |
| model | optional | — | Model of that make (e.g. Corolla, Landcruiser Prado). `models` lists them. Needs `make`. |
| badge | optional | — | Badge / trim of that model as the site lists it (e.g. Ascent Sport Hybrid). `filters` with filter=badge lists them. Needs `model`. |
| condition | optional | new · used · demo_near_new · used_only | new · used (the site's 'Used, Demo & Near New') · demo_near_new · used_only (used without demo / near-new). |
| seller_type | optional | dealer · private | dealer or private. |
| state | optional | act · nsw · nt · qld · sa · tas · vic · wa | Australian state or territory: act, nsw, nt, qld, sa, tas, vic, wa (full names accepted). |
| region | optional | — | Region as carsales names it (e.g. Sydney, Melbourne, Gold Coast, Hunter Valley exc Newcastle). `filters` with filter=region and a state lists them. |
| location | optional | — | 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 = 25 | optional | 25 · 50 · 100 · 250 · 500 · 1000 · 2000 · 5000 | Search radius around `location` — the site's own stops: 25, 50, 100, 250, 500, 1000, 2000, 5000 (default 25). |
| body_type | optional | bus · cab_chassis · convertible · coupe · hatch · light_truck · people_mover · sedan · suv · ute · van · wagon | Body 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_type | optional | petrol · diesel · hybrid · plug_in_hybrid · electric · dual_fuel · gas_only | Fuel: petrol, diesel, hybrid, plug_in_hybrid, electric, dual_fuel, gas_only. One value or several (comma-separated = any of them). |
| transmission | optional | automatic · manual · amt | automatic, manual or amt. One value or several (comma-separated = any of them). |
| drive_type | optional | 4x4 · 4x2 · 6x2 · 6x6 · front_wheel_drive · rear_wheel_drive | Drive: 4x4, 4x2, 6x2, 6x6, front_wheel_drive, rear_wheel_drive. One value or several (comma-separated = any of them). |
| colour | optional | beige · black · blue · bronze · brown · burgundy · gold · green · grey · magenta · maroon · orange · pink · purple · red · silver · white · yellow | Exterior 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). |
| cylinders | optional | 2 · 3 · 4 · 5 · 6 · 8 · 10 · 12 | Engine cylinders: 2, 3, 4, 5, 6, 8, 10, 12 (several = any). |
| doors | optional | 1 · 2 · 3 · 4 · 5 · 6 | Doors: 1-6 (several = any). |
| price_min | optional | 0– | Lowest price in AUD. |
| price_max | optional | 0– | Highest price in AUD. |
| year_min | optional | 0– | Lowest model year. |
| year_max | optional | 0– | Highest model year. |
| odometer_min | optional | 0– | Lowest odometer in km. |
| odometer_max | optional | 0– | Highest odometer in km. |
| seats_min | optional | 0– | Lowest number of seats. |
| seats_max | optional | 0– | Highest number of seats. |
| engine_size_min | optional | 0– | Lowest engine size in cc. |
| engine_size_max | optional | 0– | Highest engine size in cc. |
| power_min | optional | 0– | Lowest power in kW. |
| power_max | optional | 0– | Highest power in kW. |
| towing_min | optional | 0– | Lowest braked towing capacity in kg. |
| towing_max | optional | 0– | Highest braked towing capacity in kg. |
| ev_range_min | optional | 0– | Lowest electric driving range in km. |
| ev_range_max | optional | 0– | Highest electric driving range in km. |
| battery_capacity_min | optional | 0– | Lowest high-voltage battery capacity in kWh. |
| battery_capacity_max | optional | 0– | Highest high-voltage battery capacity in kWh. |
| power_to_weight_min | optional | 0– | Lowest power-to-weight ratio in kW/t. |
| power_to_weight_max | optional | 0– | Highest power-to-weight ratio in kW/t. |
| price_rating | optional | great · good · fair | carsales' price badge: great (Great price), good (Good price), fair (Fair price). One value or several (comma-separated = any of them). |
| ancap | optional | 5_stars_only · 4_stars_or_more · 3_stars_or_more · less_than_3_stars | ANCAP safety rating: 5_stars_only, 4_stars_or_more, 3_stars_or_more, less_than_3_stars. |
| fuel_economy | optional | 4_or_less · 5_or_less · 7_or_less · 9_or_less · 11_or_less · 11_or_more | Combined fuel economy: 4_or_less, 5_or_less, 7_or_less, 9_or_less, 11_or_less (L/100km), 11_or_more. |
| induction | optional | aspirated · turbo · supercharged · turbo_supercharged · turbo_electric_compressor · twin_turbo_electric_compressor · not_applicable | Induction: aspirated, turbo, supercharged, turbo_supercharged, turbo_electric_compressor, twin_turbo_electric_compressor, not_applicable. One value or several (comma-separated = any of them). |
| brand_origin | optional | australia · austria · china · czech_republic · france · germany · great_britain · india · italy · japan · malaysia · russia · south_korea · spain · sweden · united_states | Country the brand comes from (e.g. japan, germany, south_korea, china, australia). One value or several (comma-separated = any of them). |
| lifestyle | optional | family · first_car · green · offroad_4x4 · performance · prestige · tradie · unique | The site's lifestyle groups: family, first_car, green, offroad_4x4, performance, prestige, tradie, unique. One value or several (comma-separated = any of them). |
| ads_with | optional | photos · prices · videos · roadworthy_certificates · car_history_snapshot · manufacturer_certifications · redbook_inspections | Only listings with: photos, prices, videos, roadworthy_certificates, car_history_snapshot, manufacturer_certifications, redbook_inspections. One value or several (comma-separated = any of them). |
| certified | optional | certified · inspected | certified (manufacturer certified) or inspected (RedBook inspected). One value or several (comma-separated = any of them). |
| charge_socket | optional | ccs2 · chademo · type_1 · type_2 | EV charge socket: ccs2, chademo, type_1, type_2. One value or several (comma-separated = any of them). |
| buyers_guide | optional | top_pick · top_5 | carsales buyer's guide: top_pick or top_5. |
| best_for | optional | — | 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). |
| feature | optional | — | 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_description | optional | — | The site's engine code (e.g. 2.0t, 3.0dt, 1.8i; `filters` with filter=engine_description lists them). |
| p_plate_state | optional | act · nsw · nt · qld · sa · tas · vic · wa | Only cars P-plate approved in this state (act, nsw, nt, qld, sa, tas, vic, wa). |
| id_verified | optional | — | Only ID-verified private sellers. |
| dealer_finance | optional | — | Only dealer cars with finance available. |
| special_offers | optional | — | Only cars with special offers. |
| trade_in | optional | — | Only dealers that accept a carsales trade-in. |
| sort = featured | optional | featured · price_asc · price_desc · odometer_asc · odometer_desc · year_desc · year_asc · acceleration · power · battery_capacity · ev_range · trade_in_bonus | Order: 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 = 1 | optional | 1–20 | Page 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. |
| cursor | optional | — | 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). |
/carsales/v1/filters2 creditsThe 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.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| filter | required | 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 | Which 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. |
| query | optional | — | Keyword searched in the whole listing, as typed in the site's keyword box (e.g. 'sunroof', 'towbar', 'one owner'). |
| make | optional | — | Make as carsales spells it (e.g. Toyota, Mercedes-Benz). `makes` lists all of them with counts. |
| model | optional | — | Model of that make (e.g. Corolla, Landcruiser Prado). `models` lists them. Needs `make`. |
| badge | optional | — | Badge / trim of that model as the site lists it (e.g. Ascent Sport Hybrid). `filters` with filter=badge lists them. Needs `model`. |
| condition | optional | new · used · demo_near_new · used_only | new · used (the site's 'Used, Demo & Near New') · demo_near_new · used_only (used without demo / near-new). |
| seller_type | optional | dealer · private | dealer or private. |
| state | optional | act · nsw · nt · qld · sa · tas · vic · wa | Australian state or territory: act, nsw, nt, qld, sa, tas, vic, wa (full names accepted). |
| region | optional | — | Region as carsales names it (e.g. Sydney, Melbourne, Gold Coast, Hunter Valley exc Newcastle). `filters` with filter=region and a state lists them. |
| location | optional | — | 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 = 25 | optional | 25 · 50 · 100 · 250 · 500 · 1000 · 2000 · 5000 | Search radius around `location` — the site's own stops: 25, 50, 100, 250, 500, 1000, 2000, 5000 (default 25). |
| body_type | optional | bus · cab_chassis · convertible · coupe · hatch · light_truck · people_mover · sedan · suv · ute · van · wagon | Body 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_type | optional | petrol · diesel · hybrid · plug_in_hybrid · electric · dual_fuel · gas_only | Fuel: petrol, diesel, hybrid, plug_in_hybrid, electric, dual_fuel, gas_only. One value or several (comma-separated = any of them). |
| transmission | optional | automatic · manual · amt | automatic, manual or amt. One value or several (comma-separated = any of them). |
| drive_type | optional | 4x4 · 4x2 · 6x2 · 6x6 · front_wheel_drive · rear_wheel_drive | Drive: 4x4, 4x2, 6x2, 6x6, front_wheel_drive, rear_wheel_drive. One value or several (comma-separated = any of them). |
| colour | optional | beige · black · blue · bronze · brown · burgundy · gold · green · grey · magenta · maroon · orange · pink · purple · red · silver · white · yellow | Exterior 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). |
| cylinders | optional | 2 · 3 · 4 · 5 · 6 · 8 · 10 · 12 | Engine cylinders: 2, 3, 4, 5, 6, 8, 10, 12 (several = any). |
| doors | optional | 1 · 2 · 3 · 4 · 5 · 6 | Doors: 1-6 (several = any). |
| price_min | optional | 0– | Lowest price in AUD. |
| price_max | optional | 0– | Highest price in AUD. |
| year_min | optional | 0– | Lowest model year. |
| year_max | optional | 0– | Highest model year. |
| odometer_min | optional | 0– | Lowest odometer in km. |
| odometer_max | optional | 0– | Highest odometer in km. |
| seats_min | optional | 0– | Lowest number of seats. |
| seats_max | optional | 0– | Highest number of seats. |
| engine_size_min | optional | 0– | Lowest engine size in cc. |
| engine_size_max | optional | 0– | Highest engine size in cc. |
| power_min | optional | 0– | Lowest power in kW. |
| power_max | optional | 0– | Highest power in kW. |
| towing_min | optional | 0– | Lowest braked towing capacity in kg. |
| towing_max | optional | 0– | Highest braked towing capacity in kg. |
| ev_range_min | optional | 0– | Lowest electric driving range in km. |
| ev_range_max | optional | 0– | Highest electric driving range in km. |
| battery_capacity_min | optional | 0– | Lowest high-voltage battery capacity in kWh. |
| battery_capacity_max | optional | 0– | Highest high-voltage battery capacity in kWh. |
| power_to_weight_min | optional | 0– | Lowest power-to-weight ratio in kW/t. |
| power_to_weight_max | optional | 0– | Highest power-to-weight ratio in kW/t. |
| price_rating | optional | great · good · fair | carsales' price badge: great (Great price), good (Good price), fair (Fair price). One value or several (comma-separated = any of them). |
| ancap | optional | 5_stars_only · 4_stars_or_more · 3_stars_or_more · less_than_3_stars | ANCAP safety rating: 5_stars_only, 4_stars_or_more, 3_stars_or_more, less_than_3_stars. |
| fuel_economy | optional | 4_or_less · 5_or_less · 7_or_less · 9_or_less · 11_or_less · 11_or_more | Combined fuel economy: 4_or_less, 5_or_less, 7_or_less, 9_or_less, 11_or_less (L/100km), 11_or_more. |
| induction | optional | aspirated · turbo · supercharged · turbo_supercharged · turbo_electric_compressor · twin_turbo_electric_compressor · not_applicable | Induction: aspirated, turbo, supercharged, turbo_supercharged, turbo_electric_compressor, twin_turbo_electric_compressor, not_applicable. One value or several (comma-separated = any of them). |
| brand_origin | optional | australia · austria · china · czech_republic · france · germany · great_britain · india · italy · japan · malaysia · russia · south_korea · spain · sweden · united_states | Country the brand comes from (e.g. japan, germany, south_korea, china, australia). One value or several (comma-separated = any of them). |
| lifestyle | optional | family · first_car · green · offroad_4x4 · performance · prestige · tradie · unique | The site's lifestyle groups: family, first_car, green, offroad_4x4, performance, prestige, tradie, unique. One value or several (comma-separated = any of them). |
| ads_with | optional | photos · prices · videos · roadworthy_certificates · car_history_snapshot · manufacturer_certifications · redbook_inspections | Only listings with: photos, prices, videos, roadworthy_certificates, car_history_snapshot, manufacturer_certifications, redbook_inspections. One value or several (comma-separated = any of them). |
| certified | optional | certified · inspected | certified (manufacturer certified) or inspected (RedBook inspected). One value or several (comma-separated = any of them). |
| charge_socket | optional | ccs2 · chademo · type_1 · type_2 | EV charge socket: ccs2, chademo, type_1, type_2. One value or several (comma-separated = any of them). |
| buyers_guide | optional | top_pick · top_5 | carsales buyer's guide: top_pick or top_5. |
| best_for | optional | — | 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). |
| feature | optional | — | 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_description | optional | — | The site's engine code (e.g. 2.0t, 3.0dt, 1.8i; `filters` with filter=engine_description lists them). |
| p_plate_state | optional | act · nsw · nt · qld · sa · tas · vic · wa | Only cars P-plate approved in this state (act, nsw, nt, qld, sa, tas, vic, wa). |
| id_verified | optional | — | Only ID-verified private sellers. |
| dealer_finance | optional | — | Only dealer cars with finance available. |
| special_offers | optional | — | Only cars with special offers. |
| trade_in | optional | — | Only dealers that accept a carsales trade-in. |
| seller_id | optional | — | Only this seller's cars: the seller_id a row returns (AGC-SELLER-… dealer, SSE-SELLER-… private). |
/carsales/v1/makes2 creditsEvery make on carsales.com.au with its number of cars for sale (optionally only new / used, a state or a seller type).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| condition | optional | new · used · demo_near_new · used_only | new · used (the site's 'Used, Demo & Near New') · demo_near_new · used_only (used without demo / near-new). |
| state | optional | act · nsw · nt · qld · sa · tas · vic · wa | Australian state or territory: act, nsw, nt, qld, sa, tas, vic, wa (full names accepted). |
| seller_type | optional | dealer · private | dealer or private. |
/carsales/v1/models2 creditsEvery model of a make with its number of cars for sale (optionally only new / used, a state or a seller type).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| make | required | — | Make, e.g. Toyota (see `makes`). |
| condition | optional | new · used · demo_near_new · used_only | new · used (the site's 'Used, Demo & Near New') · demo_near_new · used_only (used without demo / near-new). |
| state | optional | act · nsw · nt · qld · sa · tas · vic · wa | Australian state or territory: act, nsw, nt, qld, sa, tas, vic, wa (full names accepted). |
| seller_type | optional | dealer · private | dealer or private. |
/carsales/v1/locations1 creditcarsales' own suburb / postcode / region lookup — the places `search` accepts in `location`, with state, postcode and region.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Suburb, postcode or region text (e.g. 'Parramatta', '3000', 'Gold Coast'). |
/carsales/v1/research2 creditscarsales' 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.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| make | required | — | Make, e.g. Toyota. |
| model | required | — | Model, e.g. Corolla. |
| year | optional | 1950–2100 | Model year, e.g. 2020 (default: the current one). |
curl -X POST https://api.reefapi.com/carsales/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"make":"Toyota","model":"Corolla"}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}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.
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.
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.
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.