Carsales.com.au Scraper

How it works

This actor is designed to extract information from carsales.com.au listings, capturing details such as vehicle make, model, year, price, mileage, location, dealer information, specifications, images, and other relevant data from car listings.

Features

This actor offers the following features:

• Multiple Page Scraping: Capable of scraping data from a variety of listing URLs. Input can be a single or multiple URLs from carsales.com.au.
• Direct Car Details Scraping: Can scrape individual car detail pages directly using specific car URLs.
• Search Results Scraping: Can scrape search result pages to get multiple car listings.
• Proxy Support: Supports proxy configuration for enhanced reliability and to avoid blocking.
• Customizable Configuration: Adjustable settings to control the number of items scraped and other extraction parameters.

How to Use

1. Set Up: Ensure you have an Apify account and access to the Apify platform.
2. Input Start URLs: Specify one or more start URLs from carsales.com.au, e.g. https://www.carsales.com.au/cars/toyota/sydney-nsw/.
3. (Optional) Configure Proxy: For better reliability, configure proxy settings (recommended: Apify Residential proxies).
4. (Optional) Set Max Items: Limit the number of listings to scrape per run.
5. Run the actor: Start the actor and wait for it to finish.
6. Download Data: Export the extracted data in your preferred format (JSON, CSV, etc.).

Input Data

The actor accepts two types of URLs:

1. Search Result Pages (Multiple Cars)

{
    "startUrls": [
        {
            //Search Result Pages (Multiple Cars)
            "url": "https://www.carsales.com.au/cars/dealer/volvo/"
        },
        {
            // Individual Car Detail Pages (Single Car)
            "url": "https://www.carsales.com.au/cars/details/2010-holden-cruze-cdx-jg-manual/SSE-AD-19192355/?gts=SSE-AD-19192355&gtsSaleId=SSE-AD-19192355&gtsViewType=showcase&rankingType=showcase"
        },
        {
            "url": "https://www.carsales.com.au/cars/?q=%28And.SellerType.Dealer._.State.Queensland._.Price.range%280..20000%29.%29"
        }
    ],
    "maxItems": 100,
    "proxy": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
}

Note: When scraping individual car detail pages, set maxItems to the number of URLs you provide. Each detail page will return one complete car record with all available data.

Output Structure

The output data typically includes:

[
    {
        "title": "2010 Holden Cruze CDX JG Manual",
        "make": "holden",
        "model": "cruze",
        "year": 2010,
        "networkId": "sse-ad-19192355",
        "badge": "cdx",
        "bodyStyle": "sedan",
        "fuelType": "diesel",
        "transmission": "manual",
        "colour": "black",
        "odometer": 129950,
        "price": 4500,
        "priceType": "egc",
        "suburb": "the gap",
        "region": "alice springs",
        "state": "nt",
        "postcode": "0870",
        "location": "the gap, alice springs, nt, 0870",
        "sellerType": "private",
        "sellerId": "sse-seller-19192355",
        "publishDate": "2011-08-31t03:29:33",
        "adType": "used",
        "saleStatus": "for sale",
        "hasImages": true,
        "canonicalUrl": "https://www.carsales.com.au/cars/details/2010-holden-cruze-cdx-jg-manual/SSE-AD-19192355/",
        "imageUrl": "https://carsales.pxcrush.net/carsales/cars/private/xfaq0bynzv2zu1qdqe8s8zek.jpg?pxc_format=jpeg&pxc_method=crop&pxc_size=1200,630",
        "categoryType": "sedan",
        "newAndUsed": "used",
        "pageIsCompact": false,
        "promoteListing": false,
        "buyHomePremium": false,
        "clearance": false,
        "isDealerBranding": false,
        "latestStock": false,
        "floorplan": "cruze",
        "pageType": "product",
        "biSearchTS": "20250904-204449-0216144",
        "biCsnEventId": "d88bc4a8-af4d-48a4-8e51-bc2de4a8e962",
        "trackingSwrveNetworkGuid": "2b0c6432-37b3-4a07-a543-5fbf176a29a3",
        "globalCsnInsightsPageType": "private",
        "globalCsnInsightsAction": "view_details",
        "globalCsnInsightsSiteSection": "all stock",
        "globalCsnInsightsNetwork": "carsales",
        "globalCsnInsightsHasImages": true,
        "globalCsnInsightsIsMerlin": true,
        "globalAepMake": "holden",
        "globalAepModel": "cruze",
        "globalAepNetwork": "carsales",
        "globalAepPageType": "details",
        "globalAepNetworkId": "sse-ad-19192355",
        "globalAepIsMerlin": true,
        "globalAepSellerType": "private",
        "globalAepState": "nt",
        "globalAepType": "private",
        "globalAepYear": 2010,
        "globalAepBodyStyle": "sedan",
        "globalAepCondition": "used",
        "globalAepPrice": 4500,
        "globalAepPriceType": "egc",
        "globalAepBadge": "cdx",
        "globalAepClearance": false,
        "globalAepColour": "black",
        "globalAepFuelType": "diesel",
        "globalAepOdometerMin": 129950,
        "globalAepRegion": "alice springs",
        "globalAepSuburb": "the gap",
        "globalAepAction": "view_details",
        "globalAepSellerId": "sse-seller-19192355",
        "globalAepVertical": "carsales",
        "globalAepSaleStatus": "for sale",
        "globalAepAdType": "used",
        "globalAepCategoryType": "sedan",
        "globalFbPageCategory": "details",
        "globalFbSiteSection": "all stock",
        "globalFbNetwork": "carsales",
        "globalFbIsMerlin": true,
        "globalBiPageType": "private",
        "globalBiServerName": "carsales",
        "globalBiNetworkId": "sse-ad-19192355",
        "globalBiGeoCountryCode": "om",
        "globalBiIsGts": false,
        "globalBiAdType": "used",
        "globalBiBodyStyle": "sedan",
        "globalCsnInsightsCondition": "used",
        "globalCsnInsightsGenericGearType": "manual",
        "globalCsnInsightsPriceType": "egc",
        "globalCsnInsightsLatestStock": false,
        "globalCsnInsightsSaleStatus": "for sale",
        "globalCsnInsightsBuyHomePremium": false,
        "globalCsnInsightsPromoteListing": false,
        "globalCsnInsightsIsDealerBranding": false,
        "globalCsnInsightsClearance": false,
        "authIsAuthenticated": false,
        "adTargetLoggedIn": false,
        "adTargetPageType": "details",
        "adTargetKw": "carsales",
        "adTargetDevice": "desktop",
        "adTargetEnv": "prod",
        "adTargetAdv": "pv",
        "adTargetAncap": 5,
        "adTargetCar": "holdencruze",
        "adTargetCat": "sedan",
        "adTargetFuel": "diesel",
        "adTargetImgloc": "https://carsales.pxcrush.net/carsales/cars/private/xfaq0bynzv2zu1qdqe8s8zek.jpg",
        "adTargetLifestyle": "firstcar",
        "adTargetLoc": "nt",
        "adTargetMakeText": "holden",
        "adTargetPcode": "0870",
        "adTargetPriceSet": 0,
        "adTargetSubcat": "small",
        "adTargetSubloc": "alicesprings",
        "adTargetVer": "cdx",
        "adTargetYearRange": "2010",
        "adTargetSection": "detailsv2",
        "adTargetLams": "has-payment-module",
        "gamAdsCorrelatorId": "7903332424244019",
        "imageHeight": 630,
        "imageWidth": 1200,
        "description": "JG CDX Sedan 4dr Man 5sp 2.0DT",
        "siteName": "www.carsales.com.au",
        "scriptFuseSrc": "https://carsales.cdn.fuseplatform.net/2008/fuse.js",
        "scriptFuseType": "script",
        "featureAdsProvider": "fuse",
        "basicInfo": {
            "link": "https://www.carsales.com.au/cars/details/2010-holden-cruze-cdx-jg-manual/SSE-AD-19192355/",
            "name": "2010 Holden Cruze CDX JG Manual",
            "model": "cruze",
            "year": "2010",
            "make": "holden",
            "spec": "JG CDX Sedan 4dr Man 5sp 2.0DT",
            "Location": "nt",
            "Region": "alice springs",
            "kms": "129950",
            "kms_categ": "",
            "fuel_type": "diesel",
            "transmission": "manual",
            "fourwd": "",
            "price_type": "used",
            "est_price": "4500",
            "number_pl": "",
            "ext_color": "black",
            "body_type": "",
            "engine_details": "",
            "powerplant_type": "",
            "model_year": "",
            "imp_history": "",
            "seller_type": "private",
            "number_of_days_listed": "",
            "dealer_name": "sse-seller-19192355",
            "dealer_address": "",
            "price": "4500",
            "registrationPlate": "",
            "publishedDate": "2011-08-31t03:29:33",
            "lastModified": "",
            "bodyStyle": "sedan",
            "overview": "JG CDX Sedan 4dr Man 5sp 2.0DT",
            "build_date": "",
            "compliance_date": "",
            "cost_to_insure": "",
            "spec_clean": "",
            "vehicle_description_full": "",
            "powerplant_type_full": "",
            "body_type_full": "",
            "transmission_full": "",
            "engine_full": "",
            "drive": ""
        }
    }
    // ...
]

Output Fields Explanation

Field	Description
title	Full title of the car listing (e.g., "2010 Holden Cruze CDX JG Manual").
make	Car manufacturer/brand (e.g., "holden").
model	Car model name (e.g., "cruze").
year	Manufacturing year of the vehicle (e.g., 2010).
networkId	Unique network identifier for the listing (e.g., "sse-ad-19192355").
badge	Vehicle badge/trim level (e.g., "cdx").
bodyStyle	Body style of the vehicle (e.g., "sedan").
fuelType	Fuel type of the vehicle (e.g., "diesel").
transmission	Transmission type (e.g., "manual").
colour	Exterior color of the vehicle (e.g., "black").
odometer	Vehicle mileage/kilometers (e.g., 129950).
price	Listed price of the vehicle (e.g., 4500).
priceType	Type of pricing (e.g., "egc" - estimated guide price).
suburb	Suburb/location name (e.g., "the gap").
region	Region name (e.g., "alice springs").
state	State abbreviation (e.g., "nt").
postcode	Postal code (e.g., "0870").
location	Combined location string (e.g., "the gap, alice springs, nt, 0870").
sellerType	Type of seller (e.g., "private").
sellerId	Unique seller identifier (e.g., "sse-seller-19192355").
publishDate	Original publication date (e.g., "2011-08-31t03:29:33").
adType	Advertisement type (e.g., "used").
saleStatus	Current sale status (e.g., "for sale").
hasImages	Boolean indicating if listing has images (e.g., true).
canonicalUrl	Canonical URL to the listing page.
imageUrl	Main image URL for the listing.
categoryType	Vehicle category type (e.g., "sedan").
newAndUsed	New or used vehicle status (e.g., "used").
pageIsCompact	Boolean indicating if page layout is compact (e.g., false).
promoteListing	Boolean indicating if listing is promoted (e.g., false).
buyHomePremium	Boolean indicating if listing has buy home premium (e.g., false).
clearance	Boolean indicating if vehicle is on clearance (e.g., false).
isDealerBranding	Boolean indicating if dealer branding is enabled (e.g., false).
latestStock	Boolean indicating if vehicle is latest stock (e.g., false).
floorplan	Floorplan/model variant (e.g., "cruze").
pageType	Type of page being viewed (e.g., "product").
biSearchTS	Business intelligence search timestamp (e.g., "20250904-204449-0216144").
biCsnEventId	Business intelligence event ID (e.g., "d88bc4a8-af4d-48a4-8e51-bc2de4a8e962").
trackingSwrveNetworkGuid	Swrve analytics network GUID (e.g., "2b0c6432-37b3-4a07-a543-5fbf176a29a3").

Global Tracking Fields:

globalCsnInsights* (Carsales Insights)

Field	Description
globalCsnInsightsPageType	Page type for Carsales insights tracking (e.g., "private").
globalCsnInsightsAction	Action being tracked (e.g., "view_details").
globalCsnInsightsSiteSection	Site section for tracking (e.g., "all stock").
globalCsnInsightsNetwork	Network name (e.g., "carsales").
globalCsnInsightsHasImages	Boolean for image presence in tracking.
globalCsnInsightsIsMerlin	Boolean indicating Merlin platform usage.
globalCsnInsightsCondition	Vehicle condition for tracking (e.g., "used").
globalCsnInsightsGenericGearType	Generic transmission type (e.g., "manual").
globalCsnInsightsPriceType	Price type for tracking (e.g., "egc").
globalCsnInsightsLatestStock	Boolean for latest stock status.
globalCsnInsightsSaleStatus	Sale status for tracking (e.g., "for sale").
globalCsnInsightsBuyHomePremium	Boolean for buy home premium.
globalCsnInsightsPromoteListing	Boolean for promoted listing.
globalCsnInsightsIsDealerBranding	Boolean for dealer branding.
globalCsnInsightsClearance	Boolean for clearance status.

globalAep* (Adobe Experience Platform)

Field	Description
globalAepMake	Vehicle make for AEP tracking (e.g., "holden").
globalAepModel	Vehicle model for AEP tracking (e.g., "cruze").
globalAepNetwork	Network for AEP tracking (e.g., "carsales").
globalAepPageType	Page type for AEP (e.g., "details").
globalAepNetworkId	Network ID for AEP (e.g., "sse-ad-19192355").
globalAepIsMerlin	Boolean for Merlin platform in AEP.
globalAepSellerType	Seller type for AEP (e.g., "private").
globalAepState	State for AEP tracking (e.g., "nt").
globalAepType	Type for AEP (e.g., "private").
globalAepYear	Year for AEP tracking (e.g., 2010).
globalAepBodyStyle	Body style for AEP (e.g., "sedan").
globalAepCondition	Condition for AEP (e.g., "used").
globalAepPrice	Price for AEP tracking (e.g., 4500).
globalAepPriceType	Price type for AEP (e.g., "egc").
globalAepBadge	Badge for AEP tracking (e.g., "cdx").
globalAepClearance	Clearance status for AEP.
globalAepColour	Color for AEP tracking (e.g., "black").
globalAepFuelType	Fuel type for AEP (e.g., "diesel").
globalAepOdometerMin	Minimum odometer for AEP (e.g., 129950).
globalAepRegion	Region for AEP (e.g., "alice springs").
globalAepSuburb	Suburb for AEP (e.g., "the gap").
globalAepAction	Action for AEP (e.g., "view_details").
globalAepSellerId	Seller ID for AEP (e.g., "sse-seller-19192355").
globalAepVertical	Vertical for AEP (e.g., "carsales").
globalAepSaleStatus	Sale status for AEP (e.g., "for sale").
globalAepAdType	Ad type for AEP (e.g., "used").
globalAepCategoryType	Category type for AEP (e.g., "sedan").

globalFb* (Facebook)

Field	Description
globalFbPageCategory	Page category for Facebook tracking (e.g., "details").
globalFbSiteSection	Site section for Facebook (e.g., "all stock").
globalFbNetwork	Network for Facebook tracking (e.g., "carsales").
globalFbIsMerlin	Boolean for Merlin in Facebook tracking.

globalBi* (Business Intelligence)

Field	Description
globalBiPageType	Page type for BI tracking (e.g., "private").
globalBiServerName	Server name for BI (e.g., "carsales").
globalBiNetworkId	Network ID for BI (e.g., "sse-ad-19192355").
globalBiGeoCountryCode	Geographic country code (e.g., "om").
globalBiIsGts	Boolean for GTS status.
globalBiAdType	Ad type for BI (e.g., "used").
globalBiBodyStyle	Body style for BI (e.g., "sedan").

Authentication & Ad Targeting:

Field	Description
authIsAuthenticated	Boolean indicating if user is authenticated (e.g., false).
adTargetLoggedIn	Boolean for ad targeting based on login status (e.g., false).
adTargetPageType	Page type for ad targeting (e.g., "details").
adTargetKw	Keywords for ad targeting (e.g., "carsales").
adTargetDevice	Device type for targeting (e.g., "desktop").
adTargetEnv	Environment for targeting (e.g., "prod").
adTargetAdv	Advertising type (e.g., "pv").
adTargetAncap	ANCAP safety rating (e.g., 5).
adTargetCar	Car identifier for targeting (e.g., "holdencruze").
adTargetCat	Category for targeting (e.g., "sedan").
adTargetFuel	Fuel type for targeting (e.g., "diesel").
adTargetImgloc	Image location URL for targeting.
adTargetLifestyle	Lifestyle targeting (e.g., "firstcar").
adTargetLoc	Location for targeting (e.g., "nt").
adTargetMakeText	Make text for targeting (e.g., "holden").
adTargetPcode	Postal code for targeting (e.g., "0870").
adTargetPriceSet	Price set indicator (e.g., 0).
adTargetSubcat	Subcategory for targeting (e.g., "small").
adTargetSubloc	Sub-location for targeting (e.g., "alicesprings").
adTargetVer	Version for targeting (e.g., "cdx").
adTargetYearRange	Year range for targeting (e.g., "2010").
adTargetSection	Section for targeting (e.g., "detailsv2").
adTargetLams	LAMS features (e.g., "has-payment-module").

Site & Technical Information:

Field	Description
gamAdsCorrelatorId	Google Ad Manager correlator ID (e.g., "7903332424244019").
imageHeight	Height of main image in pixels (e.g., 630).
imageWidth	Width of main image in pixels (e.g., 1200).
description	Page description/meta description (e.g., "JG CDX Sedan 4dr Man 5sp 2.0DT").
siteName	Website name (e.g., "www.carsales.com.au").
scriptFuseSrc	Fuse script source URL.
scriptFuseType	Fuse script type.
featureAdsProvider	Advertising provider (e.g., "fuse").

Nested basicInfo Object:

Field	Description
link	Direct URL to the car listing.
name	Full name/title of the vehicle.
model	Vehicle model.
year	Manufacturing year.
make	Vehicle manufacturer.
spec	Vehicle specification string.
Location	Location/state.
Region	Specific region.
kms	Kilometer reading.
kms_categ	Kilometer category.
fuel_type	Fuel type.
transmission	Transmission type.
fourwd	Four-wheel drive indicator.
price_type	Price type classification.
est_price	Estimated price.
number_pl	Number plate information.
ext_color	Exterior color.
body_type	Body type classification.
engine_details	Engine specification details.
powerplant_type	Powerplant/engine type.
model_year	Model year information.
imp_history	Import history.
seller_type	Type of seller.
number_of_days_listed	Days since listing was posted.
dealer_name	Dealership name.
dealer_address	Dealership address.
price	Vehicle price.
registrationPlate	Vehicle registration plate.
publishedDate	Date when listing was published.
lastModified	Last modification date.
bodyStyle	Vehicle body style.
overview	Vehicle overview/summary.
build_date	Vehicle build date.
compliance_date	Compliance date.
cost_to_insure	Insurance cost estimate.
spec_clean	Clean specification string.
vehicle_description_full	Full vehicle description.
powerplant_type_full	Complete powerplant type.
body_type_full	Complete body type description.
transmission_full	Complete transmission description.
engine_full	Complete engine description.
drive	Drivetrain type.

---

Explore More Scrapers

If you found this Apify Carsales Scraper useful, be sure to check out our other powerful scrapers and actors at memo23's Apify profile. We offer a wide range of tools to enhance your web scraping and automation needs across various platforms and use cases.

Support

• For issues or feature requests, please use the Issues section of this actor.
• If you need customization or have questions, feel free to contact the author:
  • Author's website: https://muhamed-didovic.github.io/
  • Email: muhamed.didovic@gmail.com

Additional Services

• Request customization or whole dataset: muhamed.didovic@gmail.com
• If you need anything else scraped, or this actor customized, email: muhamed.didovic@gmail.com
• For API services of this scraper (no Apify fee, just usage fee for the API), contact: muhamed.didovic@gmail.com