🚘 Autotrader.co.za Vehicle Scraper Actor

Automatically extract vehicle listings from Autotrader South Africa with structured details.

---

🌟 What Does This Do?

This actor scrapes vehicle listings from Autotrader South Africa (autotrader.co.za). It:

1. Visits Autotrader.co.za search result URLs you provide.
2. Follows pagination to capture all listings (up to 100 per page).
3. Extracts key vehicle details, including:

• 🆔 Ad ID (listingId)
• 🚘 Year, Make, Model, Variant
• 💲 Price (ZAR, numeric + string) and market price info
• 🛣️ Mileage (km string + numeric)
• ⚙️ Specifications: Transmission, Fuel, Drivetrain, Body Type, Colour, Doors, Engine, Power, Torque
• 📍 Location: Dealer/Suburb/Province
• 👤 Seller Info: Dealer Name, Rating, Private/Dealer
• 🖼️ Image URLs (multiple gallery photos)
• 📝 Description text
• 🔗 Original Listing URL

---

🛠️ Configuration

Input fields:

1. Start URLs (start_urls)

   • Provide Autotrader.co.za search URLs.
   • Example:

     [{ "url": "https://www.autotrader.co.za/cars-for-sale/all-cars/gauteng/johannesburg?price=0-to-300000" }]
     

2. Max Pages per Search (max_depth) (optional)

   • Limits how many result pages to scrape.
   • Leave 0 or empty = scrape until no new results.

3. Max Concurrent Detail Page Requests (max_concurrency) (optional)

   • Default: 20.

4. Proxy URL (proxy_url) (optional)

   • Defaults to Apify Proxy if not set.

---

🚦 Features

• Automatic Pagination (?rcp=100 where possible).
• Duplicate Detection (stops when listings repeat).
• Retries with Backoff (up to 5 attempts).
• Structured JSON Parsing from vehicle_data payload.

---

📤 Output

The actor delivers results in JSON / CSV / Excel formats.

Flattened main fields (end of CSV):

• url
• ad_id → from vehicle_data.header.listingId
• year → parsed from registrationYearMakeModel
• make, model, variant
• price_str, price_zar
• mileage_str, mileage_km
• status → from summaryIcons.0.text
• transmission → from summaryIcons.3.text
• fuel_type → from summaryIcons.4.text
• body_type → from additionalInformation.4.text
• exterior_colour → from additionalInformation.3.text
• doors → from listingSpecifications
• engine, engine_size, power_kw, torque_nm
• dealer_name, seller_suburb, dealer_rating_score, dealer_rating_count
• image_urls/*
• description

---

📝 Example Simplified Output

{
  "url": "https://www.autotrader.co.za/car-for-sale/gwm/steed-5/2.0/28174398?vf=2&db=1",
  "ad_id": 28174398,
  "year": 2025,
  "make": "GWM",
  "model": "Steed 5",
  "variant": "2.0VGT S",
  "status": "Used",
  "price_str": "R 294 900",
  "price_zar": 294900,
  "mileage_str": "12 000 km",
  "mileage_km": 12000,
  "transmission": "Manual",
  "fuel_type": "Diesel",
  "body_type": "Single cab",
  "exterior_colour": "White",
  "doors": 2,
  "engine": "2.0 turbo diesel",
  "engine_size": "2L",
  "power_kw": 110,
  "torque_nm": 320,
  "dealer_name": "GWM Haval The Glen",
  "seller_suburb": "Bassonia",
  "dealer_rating_score": 3.8,
  "dealer_rating_count": 32,
  "image_urls": [
    "https://img.autotrader.co.za/37182489/Crop800x600"
  ],
  "description": "Finance available through all major Banks. Trade in's welcome."
}