roshtarg-cpu/gumtree-south-africa-scraper

# Gumtree South Africa Scraper 🇿🇦📦 Extract classified ads from **Gumtree South Africa**, the country's leading marketplace for cars, electronics, property, jobs, and more. Get comprehensive listing data including titles, prices, locations, descriptions, and images. ## 🌟 Features - 🚗 **Multi-Category** - Cars, property, jobs, electronics, services, boats - 💰 **Price Filtering** - Filter by minimum and maximum price - 📍 **Location Search** - Target specific cities (Johannesburg, Cape Town, Durban, etc.) - 🔍 **Keyword Search** - Search by custom keywords - 🖼️ **Image URLs** - Extract listing images - ⚡ **Fast & Reliable** - Built with Playwright for robust scraping - 🔄 **Structured Output** - Clean JSON data ready for analysis ## 📋 Input Parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `category` | Select | No | "all-the-ads" | Category to scrape | | `location` | String | No | "" | City or region filter | | `searchQuery` | String | No | "" | Keywords to search | | `maxResults` | Integer | No | 10 | Maximum listings (1-100) | | `minPrice` | Integer | No | 0 | Minimum price in ZAR | | `maxPrice` | Integer | No | 999999999 | Maximum price in ZAR | ## 📤 Output Schema Each listing contains: ```json { "title": "2017 Ford Focus Hatchback 1.0 Ecoboost Automatic", "price": "R 115,000", "priceNumeric": 115000, "location": "Johannesburg South", "description": "BARGAIN SALE- Price slightly negotiable on viewing...", "category": "cars-bakkies", "url": "gumtree.co.za...", "image": "gms.gumtree.co.za...", "postedDate": "", "seller": "" } ``` ## 🚀 Usage Examples ### Browse All Cars in Johannesburg ```json { "category": "cars-bakkies", "location": "johannesburg", "maxResults": 50 } ``` ### Search for iPhones Under R5000 ```json { "category": "electronics", "searchQuery": "iphone", "maxPrice": 5000, "maxResults": 20 } ``` ### Find Jobs in Cape Town …