# AutoTrader South Africa Cars Scraper (`getascraper/autotrader-za-cars-scraper`) Actor Extract used and new car listings from AutoTrader.co.za with real price, year, and mileage filters, make/model, dealer details, and photo galleries. JSON or CSV rows ready for Sheets, Make, and Zapier. - **URL**: https://apify.com/getascraper/autotrader-za-cars-scraper.md - **Developed by:** [GetAScraper](https://apify.com/getascraper) (community) - **Categories:** E-commerce, Lead generation, Automation - **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.66 / 1,000 car listings This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 🚗 AutoTrader South Africa Cars Scraper
South Africa's largest car marketplace, now part of a regional car-data suite. AutoTrader.co.za listings sit alongside DubiCars and YallaMotor coverage for teams tracking used-car inventory across South Africa, the UAE, and the wider Gulf.
MIDDLE EAST AND AFRICA USED-CAR MARKETPLACES   •  South Africa, UAE, and wider Middle East used-car listings in one product line
 AutoTrader SA
➤ You are here 		 DubiCars UAE
Public UAE vehicle listing feed 		 YallaMotor Gulf
UAE and Gulf used-car data
South Africa's biggest car marketplace, turned into structured data.
Scrape public AutoTrader.co.za car listings with real price, mileage, and year filters, and export prices, specs, dealer info, and photo galleries to Sheets, Excel, or n8n.
🎯 Real filters
Price, mileage, and year, matched to AutoTrader's own real filter panel. 		🚙 Make & model aware
Narrow to a specific make or model, or search all of South Africa. 		🪪 Dealer context
Dealer name, location, and star rating for every listing. 		🖼️ Full galleries
Cover image plus every public listing photo.
Most AutoTrader scrapers hand you a keyword box and hope. This Actor exposes the same price, mileage, and year filters you'd use on the site itself, so what you scrape is already the inventory you actually want. ### 🔍 What does AutoTrader South Africa Cars Scraper do? AutoTrader South Africa Cars Scraper turns public car listings from [AutoTrader.co.za](https://www.autotrader.co.za/cars-for-sale), South Africa's largest car marketplace, into structured data: price, year, mileage, fuel type, transmission, dealer details, and full photo galleries. Pick a make and model and a price, mileage, or year range, or paste an AutoTrader.co.za search link built on the site itself. Run it once for a quick export, or schedule it on Apify to track inventory changes over time. The Actor returns only data present on the public listing. ### 💡 Why use it? - **Dealers and sourcing teams** can pull inventory under a price and mileage ceiling across any make or model without checking listings one by one. - **Market researchers** can track price, year, and mileage across comparable vehicles for pricing analysis. - **Buyers and resellers** can monitor a filtered slice of the market on a schedule and catch new listings as they post. - **Data teams already covering other regions** can add AutoTrader.co.za as a South African source alongside this portfolio's European and Indian car actors, since each site carries its own distinct listings and dealer network. ### 🧭 How to use it
STEP 1
Set your filters
Make/model, price, mileage, and year. 		STEP 2
Run the Actor
Set how many listings and pages to collect. 		STEP 3
Export results
Download your dataset in JSON, CSV, Excel, or HTML.
### 🧾 Input | Field | Type | Required | Description | |---|---|---|---| | `startUrls` | array of URLs | No | Paste public AutoTrader.co.za search links, built however you like on the site. Overrides Make/Model and the filters below. | | `make` | string | No | Car brand, e.g. `Toyota`, `Volkswagen`, `Land Rover`. | | `model` | string | No | Car model, e.g. `Hilux`, `Polo`. Used together with Make. | | `priceFrom` / `priceTo` | integer | No | Minimum and maximum asking price, in South African Rand. | | `yearFrom` / `yearTo` | integer | No | Earliest and latest model year. | | `mileageFromKm` / `mileageToKm` | integer | No | Minimum and maximum odometer reading, in kilometers. | | `sortOrder` | string | No | Price low/high, mileage low/high, or most recent ads. | | `maxItems` | integer | No | Maximum listings saved to the dataset. Default `25`. | | `maxPages` | integer | No | Maximum search result pages read. Default `5`. | | `proxyConfiguration` | object | No | Optional proxy settings. Not required for normal use. | ### 📦 Output Every record includes the listing link, price, year, mileage, fuel type, transmission, dealer details, and the full public photo gallery. ```json { "listing_url": "https://www.autotrader.co.za/car-for-sale/toyota/hilux/2.8gd-6/28695086", "listing_id": 28695086, "title": "Toyota Hilux 2.8GD-6 Xtra Cab Legend Auto", "make": "Toyota", "model": "Hilux", "variant": "2.8GD-6 Xtra Cab Legend Auto", "condition": "Used Car", "price": 479900, "price_formatted": "R 479 900", "currency": "ZAR", "year": 2021, "mileage_km": 178169, "fuel_type": "Diesel", "transmission": "Automatic", "seller_type": "Dealer", "dealer_name": "CITMoto", "dealer_city": "Pretoria", "dealer_rating_score": 4.7, "image_url": "https://img.autotrader.co.za/47873032", "scraped_at": "2026-08-20T13:37:18.984Z" } ``` You can download the dataset in various formats such as JSON, HTML, CSV, or Excel. ### 📊 Data table | Field | Type | Description | |---|---|---| | `listing_url`, `listing_id` | string, number | Public listing link and its source identifier. | | `title`, `make`, `model`, `variant`, `condition` | string | Listing headline, vehicle breakdown, and new/used status. | | `price`, `price_formatted`, `currency` | number, string | Asking price as a real number in Rand, the source's own formatted text (e.g. "R 379 900"), and currency. | | `year`, `mileage_km` | number | Model year and odometer reading in kilometers. | | `fuel_type`, `transmission` | string | Vehicle specification fields, when published. | | `seller_type`, `dealer_name`, `dealer_suburb`, `dealer_city` | string | Whether the seller is a dealer, and their name and location. | | `dealer_rating_score`, `dealer_rating_count` | number | Dealer star rating and how many ratings it's based on, when published. | | `image_url`, `image_urls`, `image_count` | string, array, number | Cover photo, the full public photo gallery, and total photo count. | | `is_premium`, `is_certified`, `is_special` | boolean | Listing badges, when published. | | `source_url` | string | The search URL that produced this listing. | | `scraped_at` | string | Timestamp of when this record was built. | Any field the source listing does not publish is left out of that record entirely, so you never see placeholder or made-up values. The `price` field is always the real numeric asking price; the source's formatted "R 379 900" text is kept separately in `price_formatted` for reference, never used as the numeric value. ### 💰 Pricing This Actor runs on Apify's pay-per-event pricing. You only pay for listings actually returned, and an empty or failed run costs nothing beyond a few seconds of compute. There is no subscription. ### ⭐ Enjoying AutoTrader South Africa Cars Scraper?
⭐ ⭐ ⭐ ⭐ ⭐
This Actor just saved you from checking AutoTrader listings one at a time.
A 5-star rating takes 10 seconds and helps other dealers, researchers, and buyers find it. Your feedback also tells us what to build next.
★  Rate this Actor on Apify
### 🛠️ Tips and advanced options - Set both `priceFrom` and `priceTo` together to cut down on irrelevant results fast. - `make` and `model` accept any brand or model AutoTrader covers, not just the popular ones. Use the name as it appears on the site, e.g. `Land Rover`, `Mercedes-Benz`. - For a search you don't see modeled cleanly, paste that search directly from AutoTrader.co.za into `startUrls`; the Actor follows any valid AutoTrader car search link. - Use `sortOrder` with a small `maxItems` to grab just the cheapest or most recent listings for a make/model without paging through the whole inventory. ### ❓ FAQ **Why is `price` a plain number instead of the "R 379 900" text I see on the site?** AutoTrader's own display price is a formatted string with spacing that isn't something you can sort, filter, or chart directly. This Actor converts it to a real number in Rand for the `price` field, and keeps the original formatted text separately in `price_formatted` for reference. **Can I filter by a specific make or model?** Yes, with the `make` and `model` input fields, or by pasting a make/model search link from AutoTrader.co.za into `startUrls` for anything not covered cleanly by those fields. **Why is a field missing from an item?** AutoTrader listings don't publish every detail on every listing. Missing values are omitted rather than replaced with guesses. **Is this affiliated with AutoTrader?** No. This is an independent tool that collects publicly available listing information. Use it in line with applicable rules and the source website's terms. Found a bug or want a feature added? Open an issue on the Actor's Issues tab, or reach out for a custom version of this Actor. ### 🔗 Other actors - [Standvirtual Cars Scraper: Carros usados](https://apify.com/getascraper/standvirtual-cars-scraper) ↗ - Used-car listings from Portugal's largest car marketplace. - [Carwale Used Cars Scraper: India Listings](https://apify.com/getascraper/carwale-used-cars-scraper) ↗ - Used-car listings from one of India's largest car marketplaces. - [OtoMoto Cars Scraper: Samochody używane](https://apify.com/getascraper/otomoto-cars-scraper) ↗ - Used-car inventory from Poland's largest car marketplace. - [Marktplaats Cars Scraper: Tweedehands auto's](https://apify.com/getascraper/marktplaats-cars-scraper) ↗ - Used-car listings from the Netherlands. - [Blocket Cars Scraper: Bilar till salu](https://apify.com/getascraper/blocket-cars-scraper) ↗ - Used-car listings from Sweden's largest classifieds marketplace. # Actor input Schema ## `startUrls` (type: `array`): Paste one or more AutoTrader.co.za car search links directly, built however you like on the site itself. When set, this replaces Make/Model and the filters below. Leave empty to build the search from those fields instead. ## `make` (type: `string`): Car brand, e.g. "Toyota", "Volkswagen", "Land Rover". Matches AutoTrader's own make filter, applied as part of the search URL. Leave blank to search all makes. ## `model` (type: `string`): Car model, e.g. "Hilux", "Polo", "Range Rover Evoque". Only used together with Make. Leave blank to search all models of the chosen make. ## `priceFrom` (type: `integer`): Minimum asking price in South African Rand. ## `priceTo` (type: `integer`): Maximum asking price in South African Rand. ## `yearFrom` (type: `integer`): Earliest model year. ## `yearTo` (type: `integer`): Latest model year. ## `mileageFromKm` (type: `integer`): Minimum odometer reading in kilometers. ## `mileageToKm` (type: `integer`): Maximum odometer reading in kilometers. ## `sortOrder` (type: `string`): How results are ordered. Default follows AutoTrader's own default relevance order. ## `proxyConfiguration` (type: `object`): Optional proxy settings. AutoTrader.co.za works with a direct connection by default. ## `maxItems` (type: `integer`): Maximum number of unique car listings to return. ## `maxPages` (type: `integer`): Maximum number of search result pages to visit. ## Actor input object example ```json { "startUrls": [], "make": "Toyota", "model": "Hilux", "sortOrder": "", "proxyConfiguration": { "useApifyProxy": false }, "maxItems": 10, "maxPages": 2 } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [], "make": "Toyota", "model": "Hilux", "sortOrder": "", "proxyConfiguration": { "useApifyProxy": false }, "maxItems": 10, "maxPages": 2 }; // Run the Actor and wait for it to finish const run = await client.actor("getascraper/autotrader-za-cars-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [], "make": "Toyota", "model": "Hilux", "sortOrder": "", "proxyConfiguration": { "useApifyProxy": False }, "maxItems": 10, "maxPages": 2, } # Run the Actor and wait for it to finish run = client.actor("getascraper/autotrader-za-cars-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [], "make": "Toyota", "model": "Hilux", "sortOrder": "", "proxyConfiguration": { "useApifyProxy": false }, "maxItems": 10, "maxPages": 2 }' | apify call getascraper/autotrader-za-cars-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,getascraper/autotrader-za-cars-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/cb6cBSNcP7QgaNfzZ/builds/g9PX6pv06pbtUkE5E/openapi.json