# Webuycars Cars Search Scraper (`stealth_mode/webuycars-cars-search-scraper`) Actor Scrape WeBuyCars.co.za search results and collect 90+ data fields per vehicle — specs, pricing, condition, images, roadworthy status, and more. Perfect for dealers, analysts, and automotive platforms needing structured used-car data from South Africa's largest pre-owned marketplace. - **URL**: https://apify.com/stealth\_mode/webuycars-cars-search-scraper.md - **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community) - **Categories:** Automation, Developer tools, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 results 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 ## WeBuyCars.co.za Scraper: Extract Used Car Listings at Scale **Excerpt:** Scrape WeBuyCars.co.za search results and collect 90+ data fields per vehicle — specs, pricing, condition, images, roadworthy status, and more. Perfect for dealers, analysts, and automotive platforms needing structured used-car data from South Africa's largest pre-owned marketplace. --- ### What Is WeBuyCars.co.za? WeBuyCars.co.za is one of South Africa's largest used vehicle marketplaces, offering thousands of pre-owned cars, SUVs, and commercial vehicles across multiple branches nationwide. The platform provides rich listing data including technical specifications, pricing grades, inspection results, and finance options — making it a valuable source for automotive market intelligence. Manually collecting this data across hundreds of paginated search pages is impractical. The **WeBuyCars.co.za Cars Search Scraper** automates extraction, turning search result pages into clean, structured datasets ready for analysis or integration. --- ### Overview This scraper targets WeBuyCars search and listing pages, collecting up to 90+ fields per vehicle record. It is suited for: - **Car dealers** monitoring competitor pricing and stock - **Automotive analysts** tracking market trends in South Africa - **Finance companies** assessing vehicle valuation data at scale - **Aggregator platforms** building or enriching used-car databases - **Researchers** studying the pre-owned vehicle market by province, make, or body type The scraper supports pagination via URL parameters, bulk URL input, and configurable item limits — enabling both targeted and large-scale collection runs. --- ### Input Format ```json { "urls": ["https://www.webuycars.co.za/buy-a-car?page=2"], "ignore_url_failures": true, "max_items_per_url": 20 } ```` | Field | Type | Description | |---|---|---| | `urls` | `array` | One or more WeBuyCars search/listing page URLs. Supports pagination via `?page=N`. Add URLs one by one or use bulk edit. | | `ignore_url_failures` | `boolean` | If `true`, the scraper continues if a URL fails instead of halting the entire run. Recommended for bulk jobs. Default: `true`. | | `max_items_per_url` | `integer` | Maximum number of vehicle records to collect per URL. Default: `20`. Increase for deeper pagination coverage. | **Tips:** - To scrape multiple pages, add each paginated URL separately: `?page=1`, `?page=2`, etc. - Filter by make, province, or body type using WeBuyCars search filters before copying the URL. - Keep `ignore_url_failures: true` for large batches to avoid interruptions from occasional failed pages. *** ### Output Format **Sample output** ```json { "data_timestamp": "2026-05-15T13:00:00.58+00:00", "category": "Vehicle", "subcategory": "SUV", "filter_category": "Vehicle", "colour": "Silver", "condition": "Shows signs of excessive wear and tear", "dealer_key": "JHB South (GP)", "branch_code": "JBS", "province": "Gauteng", "description": "2019 Mahindra KUV 100 1.2td K6+ NXT", "make": "Mahindra", "model": "KUV 100", "mileage": 69194, "online_description": "2019 Mahindra KUV 100 1.2td K6+ NXT", "variant": "1.2td K6+ NXT", "price": 115900, "stock_number": "A53810207", "internal_stock_number": "26.04.10207", "buy_lead_code": "LZD200587", "year": 2019, "vehicle_barcode": "20459707", "axle_configuration": "4X2", "body_type": "Sports Utility Vehicle (SUV)", "no_of_doors": "5", "drive": "F", "seats": "5", "use": "GEN", "wheelbase": "2385", "gearbox": "Manual", "no_gears": "5", "cooling": "W", "cubic_capacity": "1198", "cyl_configuration": "I", "engine_cycle": "4", "fuel_tank_size": "35", "fuel_type": "Diesel", "fuel_consumption": 5.9, "fuel_highway": 4, "fuel_urban": 5, "boot_capacity": 243, "disk_drive_unique_reference": "MAHMK1005201803", "kilowatts": "57", "no_cylinders": "3", "turbo_or_super_charged": "T", "gvm": null, "tare": "1155", "front_no_tyres": "2", "front_tyre_size": "185/65 R14", "rear_no_tyres": "2", "rear_tyre_size": "185/65 R14", "co2": null, "length": "3675", "height": "1635", "width": "1715", "active_warranty": false, "active_maintenance": false, "mm_code_frequency": "High", "mm_code_frequency_weight": 2, "opening_bid": 0, "buy_now_price": 115900, "service_history": "Partial", "last_service_date": "2026-04-14T00:00:00+00:00", "last_service_km": null, "license_disk": "", "has_spare_key": true, "stock_status": "Stock", "status": "For Sale", "finance_grade": "A", "pricing_grade": "Grade2 Shows signs of excessive wear and tear", "last_price_update_date": "2026-05-13T15:10:35.227", "vin": null, "vehicle_status": "Used", "assigned_parking_bay": "", "monthly_instalment": 2439, "vehicle_type": "A", "has_any_roadworthy_relevant_issues": false, "roadworthy_relevant_issues": 0, "has_roadworthy_voucher": false, "has_roadworthy_completed": false, "images": { "internal": "https://photos.webuycars.co.za/photobooth/A53810207/Int360/A53810207360.jpg", "external": [ "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736000.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736001.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736002.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736003.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736004.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736005.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736006.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736007.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736008.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736009.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736010.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736011.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736012.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736013.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736014.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736015.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736016.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736017.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736018.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736019.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736020.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736021.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736022.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736023.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736024.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736025.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736026.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736027.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736028.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736029.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736030.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736031.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736032.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736033.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736034.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736035.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736036.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736037.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736038.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736039.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736040.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736041.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736042.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736043.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736044.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736045.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736046.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736047.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736048.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736049.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736050.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736051.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736052.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736053.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736054.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736055.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736056.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736057.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736058.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Ext360/A5381020736059.webp" ], "other": [ "https://photos.webuycars.co.za/photobooth/A53810207/Images/A538102070.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Images/A5381020711.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Images/A5381020712.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Images/A5381020713.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Images/A5381020714.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Images/A5381020715.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Images/A5381020716.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Images/A5381020717.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Images/A5381020718.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Images/A5381020720.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Images/A5381020721.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Images/A5381020726.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Images/A538102075.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Images/A538102076.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Images/A538102077.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Images/A538102078.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Images/A538102079.webp" ], "thumbnail": [ "https://photos.webuycars.co.za/photobooth/A53810207/Thumbnails/A538102070.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Thumbnails/A5381020711.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Thumbnails/A5381020712.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Thumbnails/A5381020713.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Thumbnails/A5381020714.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Thumbnails/A5381020715.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Thumbnails/A5381020716.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Thumbnails/A5381020717.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Thumbnails/A5381020718.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Thumbnails/A5381020720.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Thumbnails/A5381020721.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Thumbnails/A5381020726.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Thumbnails/A538102075.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Thumbnails/A538102076.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Thumbnails/A538102077.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Thumbnails/A538102078.webp", "https://photos.webuycars.co.za/photobooth/A53810207/Thumbnails/A538102079.webp" ], "social": [ "https://photos.webuycars.co.za/photobooth/A53810207/Social/A53810207020260515125839291.jpg" ], "feed": [ "https://photos.webuycars.co.za/photobooth/A53810207/Feed/A538102070.jpeg", "https://photos.webuycars.co.za/photobooth/A53810207/Feed/A5381020711.jpeg", "https://photos.webuycars.co.za/photobooth/A53810207/Feed/A5381020712.jpeg", "https://photos.webuycars.co.za/photobooth/A53810207/Feed/A5381020713.jpeg", "https://photos.webuycars.co.za/photobooth/A53810207/Feed/A5381020714.jpeg", "https://photos.webuycars.co.za/photobooth/A53810207/Feed/A5381020715.jpeg", "https://photos.webuycars.co.za/photobooth/A53810207/Feed/A5381020716.jpeg", "https://photos.webuycars.co.za/photobooth/A53810207/Feed/A5381020717.jpeg", "https://photos.webuycars.co.za/photobooth/A53810207/Feed/A5381020718.jpeg", "https://photos.webuycars.co.za/photobooth/A53810207/Feed/A5381020720.jpeg", "https://photos.webuycars.co.za/photobooth/A53810207/Feed/A5381020721.jpeg", "https://photos.webuycars.co.za/photobooth/A53810207/Feed/A5381020726.jpeg", "https://photos.webuycars.co.za/photobooth/A53810207/Feed/A538102075.jpeg", "https://photos.webuycars.co.za/photobooth/A53810207/Feed/A538102076.jpeg", "https://photos.webuycars.co.za/photobooth/A53810207/Feed/A538102077.jpeg", "https://photos.webuycars.co.za/photobooth/A53810207/Feed/A538102078.jpeg", "https://photos.webuycars.co.za/photobooth/A53810207/Feed/A538102079.jpeg" ], "shop": [ "https://photos.webuycars.co.za/photobooth/A53810207/Shop/A53810207020260515125839719.jpg" ] }, "image_paths": [], "video_review_url": "https://vimeo.com/1192500064", "eval_service_history": null, "eval_maintenance_active": null, "eval_warranty_active": null, "eval_has_car_play_android_auto": null, "eval_has_reverse_camera": null, "eval_has_auto_stop_start": null, "default_sort_order": 19, "stock_tag": "Average", "stock_flag": "AAARecon", "display_rules": [ { "applied_to": "UserAnonymous", "rule_name": "HasRoadworthyVoucher", "value": "False" }, { "applied_to": "UserAnonymous", "rule_name": "HasInspectionReport", "value": "True" }, { "applied_to": "UserAnonymous", "rule_name": "InspectionCondition", "value": "Ready" }, { "applied_to": "UserAnonymous", "rule_name": "IsOnAuction", "value": "False" }, { "applied_to": "UserAnonymous", "rule_name": "FinanceType", "value": "Other" }, { "applied_to": "UserAnonymous", "rule_name": "CanBuyNow", "value": "True" }, { "applied_to": "UserAnonymous", "rule_name": "CanBuyNowOnAuction", "value": "False" }, { "applied_to": "UserAnonymous", "rule_name": "CanGetFinance", "value": "True" }, { "applied_to": "UserAnonymous", "rule_name": "CanTradeIn", "value": "True" }, { "applied_to": "UserAnonymous", "rule_name": "CanRegisterToBid", "value": "False" }, { "applied_to": "UserAnonymous", "rule_name": "CanSeeFromPrice", "value": "True" }, { "applied_to": "UserAnonymous", "rule_name": "CanFinanceAuction", "value": "False" }, { "applied_to": "UserAnonymous", "rule_name": "CanDisplayPrice", "value": "True" }, { "applied_to": "UserAnonymous", "rule_name": "CanDisplayVideo", "value": "False" }, { "applied_to": "UserPrivate", "rule_name": "HasRoadworthyVoucher", "value": "False" }, { "applied_to": "UserPrivate", "rule_name": "HasInspectionReport", "value": "True" }, { "applied_to": "UserPrivate", "rule_name": "InspectionCondition", "value": "Ready" }, { "applied_to": "UserPrivate", "rule_name": "IsOnAuction", "value": "False" }, { "applied_to": "UserPrivate", "rule_name": "FinanceType", "value": "Other" }, { "applied_to": "UserPrivate", "rule_name": "CanBuyNow", "value": "True" }, { "applied_to": "UserPrivate", "rule_name": "CanBuyNowOnAuction", "value": "False" }, { "applied_to": "UserPrivate", "rule_name": "CanGetFinance", "value": "True" }, { "applied_to": "UserPrivate", "rule_name": "CanTradeIn", "value": "True" }, { "applied_to": "UserPrivate", "rule_name": "CanRegisterToBid", "value": "False" }, { "applied_to": "UserPrivate", "rule_name": "CanSeeFromPrice", "value": "True" }, { "applied_to": "UserPrivate", "rule_name": "CanFinanceAuction", "value": "False" }, { "applied_to": "UserPrivate", "rule_name": "CanDisplayPrice", "value": "True" }, { "applied_to": "UserPrivate", "rule_name": "CanDisplayVideo", "value": "False" }, { "applied_to": "UserDealership", "rule_name": "HasRoadworthyVoucher", "value": "False" }, { "applied_to": "UserDealership", "rule_name": "HasInspectionReport", "value": "True" }, { "applied_to": "UserDealership", "rule_name": "InspectionCondition", "value": "Ready" }, { "applied_to": "UserDealership", "rule_name": "IsOnAuction", "value": "False" }, { "applied_to": "UserDealership", "rule_name": "FinanceType", "value": "Other" }, { "applied_to": "UserDealership", "rule_name": "CanBuyNow", "value": "True" }, { "applied_to": "UserDealership", "rule_name": "CanBuyNowOnAuction", "value": "False" }, { "applied_to": "UserDealership", "rule_name": "CanGetFinance", "value": "False" }, { "applied_to": "UserDealership", "rule_name": "CanTradeIn", "value": "False" }, { "applied_to": "UserDealership", "rule_name": "CanRegisterToBid", "value": "False" }, { "applied_to": "UserDealership", "rule_name": "CanSeeFromPrice", "value": "False" }, { "applied_to": "UserDealership", "rule_name": "CanFinanceAuction", "value": "False" }, { "applied_to": "UserDealership", "rule_name": "CanDisplayPrice", "value": "True" }, { "applied_to": "UserDealership", "rule_name": "CanDisplayVideo", "value": "True" }, { "applied_to": "UserWholesaler", "rule_name": "HasRoadworthyVoucher", "value": "False" }, { "applied_to": "UserWholesaler", "rule_name": "HasInspectionReport", "value": "True" }, { "applied_to": "UserWholesaler", "rule_name": "InspectionCondition", "value": "Ready" }, { "applied_to": "UserWholesaler", "rule_name": "IsOnAuction", "value": "False" }, { "applied_to": "UserWholesaler", "rule_name": "FinanceType", "value": "Other" }, { "applied_to": "UserWholesaler", "rule_name": "CanBuyNow", "value": "True" }, { "applied_to": "UserWholesaler", "rule_name": "CanBuyNowOnAuction", "value": "False" }, { "applied_to": "UserWholesaler", "rule_name": "CanGetFinance", "value": "False" }, { "applied_to": "UserWholesaler", "rule_name": "CanTradeIn", "value": "False" }, { "applied_to": "UserWholesaler", "rule_name": "CanRegisterToBid", "value": "False" }, { "applied_to": "UserWholesaler", "rule_name": "CanSeeFromPrice", "value": "False" }, { "applied_to": "UserWholesaler", "rule_name": "CanFinanceAuction", "value": "False" }, { "applied_to": "UserWholesaler", "rule_name": "CanDisplayPrice", "value": "True" }, { "applied_to": "UserWholesaler", "rule_name": "CanDisplayVideo", "value": "True" }, { "applied_to": "UserCompany", "rule_name": "HasRoadworthyVoucher", "value": "False" }, { "applied_to": "UserCompany", "rule_name": "HasInspectionReport", "value": "True" }, { "applied_to": "UserCompany", "rule_name": "InspectionCondition", "value": "Ready" }, { "applied_to": "UserCompany", "rule_name": "IsOnAuction", "value": "False" }, { "applied_to": "UserCompany", "rule_name": "FinanceType", "value": "Other" }, { "applied_to": "UserCompany", "rule_name": "CanBuyNow", "value": "True" }, { "applied_to": "UserCompany", "rule_name": "CanBuyNowOnAuction", "value": "False" }, { "applied_to": "UserCompany", "rule_name": "CanGetFinance", "value": "True" }, { "applied_to": "UserCompany", "rule_name": "CanTradeIn", "value": "True" }, { "applied_to": "UserCompany", "rule_name": "CanRegisterToBid", "value": "False" }, { "applied_to": "UserCompany", "rule_name": "CanSeeFromPrice", "value": "False" }, { "applied_to": "UserCompany", "rule_name": "CanFinanceAuction", "value": "False" }, { "applied_to": "UserCompany", "rule_name": "CanDisplayPrice", "value": "True" }, { "applied_to": "UserCompany", "rule_name": "CanDisplayVideo", "value": "False" } ], "inspection_condition": "Ready", "inspection_details": [ { "description": "", "comments": "", "repair_way": "", "has_inspection": false } ], "sync_hash": "9ae5c5aa7bb6950e8949209795dd185e35cc6fc5de2c9575f6297966e6e6a8e2" } ``` Each vehicle record contains **90+ fields** grouped below by category: #### Listing & Identification | Field | Meaning | |---|---| | `Data Timestamp` | When the record was scraped | | `Stock Number` | Public stock reference number | | `Internal Stock Number` | Internal warehouse/branch stock ID | | `Vehicle Barcode` | Physical barcode assigned to the vehicle | | `VIN` | Vehicle Identification Number | | `Buy Lead Code` | Internal lead tracking code | | `Disk Drive Unique Reference` | Unique digital reference for the listing | | `Sync Hash` | Hash used for data synchronisation and deduplication | #### Vehicle Identity | Field | Meaning | |---|---| | `Make` | Manufacturer (e.g., Toyota, BMW) | | `Model` | Model name (e.g., Hilux, 3 Series) | | `Variant` | Specific trim/variant (e.g., 2.0 TDI Comfortline) | | `Year` | Manufacturing year | | `Description` | Full listing title as displayed | | `Online Description` | Marketing description shown on the listing page | | `Colour` | Exterior colour | | `Condition` | Vehicle condition classification | | `Body Type` | e.g., Sedan, SUV, Bakkie | | `Vehicle Type` | Broad category (e.g., passenger, commercial) | | `Category` / `Subcategory` / `Filter Category` | Hierarchical classification used on-site | #### Technical Specifications | Field | Meaning | |---|---| | `Cubic Capacity` | Engine displacement in cc | | `No Cylinders` | Number of cylinders | | `Cyl Configuration` | Cylinder layout (e.g., inline-4, V6) | | `Engine Cycle` | 2-stroke or 4-stroke | | `Turbo Or Super Charged` | Whether forced induction is present | | `Kilowatts` | Engine power output (kW) | | `Cooling` | Cooling system type (air/water) | | `Fuel Type` | Petrol, diesel, hybrid, electric, etc. | | `Fuel Tank Size` | Tank capacity in litres | | `Fuel Consumption` | Combined consumption (L/100km) | | `Fuel Highway` | Highway fuel consumption | | `Fuel Urban` | Urban/city fuel consumption | | `CO2` | Emissions rating (g/km) | | `Gearbox` | Manual or automatic | | `No Gears` | Number of gears | | `Drive` | Drive configuration (FWD, RWD, AWD, 4x4) | | `Axle Configuration` | Axle layout (relevant for commercial vehicles) | #### Dimensions & Capacity | Field | Meaning | |---|---| | `No Of Doors` | Number of doors | | `Seats` | Seating capacity | | `Boot Capacity` | Boot/cargo volume in litres | | `Wheelbase` | Distance between axles (mm) | | `Length` / `Height` / `Width` | Vehicle exterior dimensions (mm) | | `GVM` | Gross Vehicle Mass (kg) | | `Tare` | Unladen vehicle weight (kg) | | `Front No Tyres` / `Front Tyre Size` | Front tyre count and size spec | | `Rear No Tyres` / `Rear Tyre Size` | Rear tyre count and size spec | #### Pricing & Finance | Field | Meaning | |---|---| | `Price` | Listed retail price (ZAR) | | `Opening Bid` | Starting bid price (auction context) | | `Buy Now Price` | Fixed purchase price option | | `Monthly Instalment` | Estimated monthly finance payment | | `Finance Grade` | Internal finance eligibility grade | | `Pricing Grade` | Internal pricing tier/grade | | `Last Price Update Date` | When the price was last revised | | `MM Code Frequency` | Market valuation frequency code | | `MM Code Frequency Weight` | Weighting applied to valuation code | #### Location & Stock | Field | Meaning | |---|---| | `Province` | South African province where the vehicle is stocked | | `Branch Code` | Specific WeBuyCars branch identifier | | `Dealer Key` | Internal dealer/branch key | | `Assigned Parking Bay` | Physical bay location at the branch | | `Stock Status` | Current inventory status | | `Status` | Listing publication status | | `Vehicle Status` | Operational/availability status | | `Default Sort Order` | Position in default search results | | `Stock Tag` / `Stock Flag` | Internal classification tags | | `Display Rules` | Rules controlling how the listing is shown | | `Use` | Intended use type (private, commercial, etc.) | | `Mileage` | Odometer reading (km) | #### Condition & Inspection | Field | Meaning | |---|---| | `Inspection Condition` | Overall inspection condition rating | | `Inspection Details` | Detailed inspection findings | | `Has Any Roadworthy Relevant Issues` | Boolean flag for roadworthy concerns | | `Roadworthy Relevant Issues` | Description of any issues found | | `Has Roadworthy Voucher` | Whether a roadworthy certificate is included | | `Has Roadworthy Completed` | Whether roadworthy inspection is complete | #### Service & Maintenance History | Field | Meaning | |---|---| | `Service History` | Type of service history (full, partial, none) | | `Last Service Date` | Date of most recent service | | `Last Service KM` | Odometer reading at last service | | `License Disk` | Whether a valid license disk is present | | `Has Spare Key` | Whether a spare key is included | | `Active Warranty` | Whether an active warranty is in place | | `Active Maintenance` | Whether a maintenance plan is active | #### Evaluated Features (Eval Fields) These fields reflect structured evaluation results from WeBuyCars inspectors: | Field | Meaning | |---|---| | `Eval Service History` | Inspector-evaluated service history rating | | `Eval Maintenance Active` | Confirmed maintenance plan status | | `Eval Warranty Active` | Confirmed warranty status | | `Eval Has Car Play Android Auto` | Whether Apple CarPlay/Android Auto is present | | `Eval Has Reverse Camera` | Whether a reverse camera is fitted | | `Eval Has Auto Stop Start` | Whether auto stop-start technology is fitted | #### Media | Field | Meaning | |---|---| | `Images` | Array of vehicle image objects | | `Image Paths` | Direct CDN paths to vehicle photos | | `Video Review URL` | Link to video walkaround/review if available | *** ### How to Use 1. **Build your search URL** — Apply filters on WeBuyCars (province, make, body type, price range) and copy the results page URL. 2. **Add pagination** — Append `?page=2`, `?page=3`, etc. for deeper coverage. Add each page as a separate URL entry. 3. **Configure limits** — Set `max_items_per_url` based on how many listings appear per page (typically 20–50). 4. **Run and export** — Start the scraper and download results as JSON or CSV for use in Excel, BI tools, or databases. **Best practices:** - Use `ignore_url_failures: true` for bulk multi-page runs. - Filter by province before scraping to segment results cleanly. - Cross-reference `VIN` and `Stock Number` for deduplication when merging multiple runs. *** ### Use Cases & Business Value - **Price benchmarking:** Compare WeBuyCars pricing against other SA used-car platforms by make, model, and year - **Stock monitoring:** Track inventory availability and turnover by branch or province - **Valuation models:** Feed mileage, spec, and pricing data into ML-based vehicle valuation tools - **Market research:** Analyse supply trends in specific segments (e.g., diesel bakkies, sub-R200k sedans) *** ### Conclusion The **WeBuyCars.co.za Cars Search Scraper** delivers one of the most comprehensive used-vehicle datasets available for the South African market. With 90+ structured fields per listing — from engine specs to roadworthy status to finance grades — it provides everything needed for serious automotive data work. Run it today and transform WeBuyCars listings into a competitive intelligence asset. # Actor input Schema ## `urls` (type: `array`): Add the URLs of the Cars list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list. ## `ignore_url_failures` (type: `boolean`): If true, the scraper will continue running even if some URLs fail to be scraped. ## `max_items_per_url` (type: `integer`): The maximum number of items to scrape per URL. ## Actor input object example ```json { "urls": [ "https://www.webuycars.co.za/buy-a-car?page=2" ], "ignore_url_failures": true, "max_items_per_url": 20 } ``` # 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 = { "urls": [ "https://www.webuycars.co.za/buy-a-car?page=2" ], "ignore_url_failures": true, "max_items_per_url": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("stealth_mode/webuycars-cars-search-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 = { "urls": ["https://www.webuycars.co.za/buy-a-car?page=2"], "ignore_url_failures": True, "max_items_per_url": 20, } # Run the Actor and wait for it to finish run = client.actor("stealth_mode/webuycars-cars-search-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "urls": [ "https://www.webuycars.co.za/buy-a-car?page=2" ], "ignore_url_failures": true, "max_items_per_url": 20 }' | apify call stealth_mode/webuycars-cars-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=stealth_mode/webuycars-cars-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Webuycars Cars Search Scraper", "description": "Scrape WeBuyCars.co.za search results and collect 90+ data fields per vehicle — specs, pricing, condition, images, roadworthy status, and more. Perfect for dealers, analysts, and automotive platforms needing structured used-car data from South Africa's largest pre-owned marketplace.", "version": "0.0", "x-build-id": "iea2Bg7Z6yh05FWrF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stealth_mode~webuycars-cars-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stealth_mode-webuycars-cars-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/stealth_mode~webuycars-cars-search-scraper/runs": { "post": { "operationId": "runs-sync-stealth_mode-webuycars-cars-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/stealth_mode~webuycars-cars-search-scraper/run-sync": { "post": { "operationId": "run-sync-stealth_mode-webuycars-cars-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "urls": { "title": "URLs of the Cars list urls to scrape", "type": "array", "description": "Add the URLs of the Cars list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.", "items": { "type": "string" } }, "ignore_url_failures": { "title": "Continue running even if some URLs fail to be scraped", "type": "boolean", "description": "If true, the scraper will continue running even if some URLs fail to be scraped." }, "max_items_per_url": { "title": "Max items per URL", "type": "integer", "description": "The maximum number of items to scrape per URL." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```