Gumtree Scraper

Pull classified ads from Gumtree at scale across three country sites — UK (gumtree.com), South Africa (gumtree.co.za), and Australia (gumtree.com.au). Get titles, prices in local currency, locations with geo-coordinates, descriptions, image galleries, structured attributes (mileage, year, beds, baths), seller name and type, and phone numbers where the seller has published one. Built for classifieds resellers, used-car dealers, and pricing-intelligence teams who need fresh, structured Gumtree data without stitching together three different country sites and parsing inconsistent HTML.

Why This Scraper?

• Three country sites, one schema — UK, South Africa, and Australia listings normalised into a single flat row shape with the same 27 fields, so a downstream CSV doesn't care which domain a listing came from.
• Cars & Vehicles across the UK, ZA, and AU — used-car pricing in the United Kingdom, pan-regional South Africa (gumtree.co.za/s-cars-bakkies), and Australia-wide (gumtree.com.au cars), with mileage, year, transmission, fuel type, body type, make, model, and drivetrain pulled into structured attributes.
• Six UK + ZA top-level categories — Cars & Vehicles, Property (Houses & Flats), Jobs, Pets, Community, and the For Sale general-goods catalogue. Australia is focused on Cars & Vehicles.
• Daily monitoring via listingStartDate early-stop — set a cutoff date and pagination stops the moment listings get older than that, so an overnight delta run pays for new ads only — typically a 90% credit saving versus a full re-crawl.
• Seller-type identification for trust signals — every listing tagged business vs private, with the seller display name captured, so dealer-only or private-only filtering happens at the dataset level instead of in your post-processing.
• Geo-coordinates and postcodes on detail rows — latitude, longitude, and postcode populated where Gumtree publishes rich location data on the listing detail page, ready for map plotting or radius search.
• Free-text location or postcode prefix — London, Manchester, Cape Town, Perth, SW1A all resolve to the right region slug automatically; no need to hand-craft /cars/uk/london style paths.
• Phone-number capture for South Africa & Australia cars — toggle includePhone to pick up the seller's published phone number on gumtree.co.za listings and gumtree.com.au cars where the dealer has exposed it. United Kingdom phone numbers stay behind Gumtree's click-to-reveal masking and are reported as null rather than returned half-masked.
• Up to 50,000 listings per run with maxResults: 0 for unlimited (a 50k safety cap applies). Each individual search caps at roughly 1,800 rows from page-pagination depth — for larger pulls, split your run across multiple startUrls.

Use Cases

Market Research & Pricing Intelligence

• Track second-hand price curves for iPhones, PS5s, or vintage furniture across UK and ZA monthly snapshots
• Compare regional used-car pricing — same make/model, mileage band, in London vs Manchester vs Cape Town vs Sydney
• Benchmark dealer asking prices against private-seller asking prices on the same model
• Build a "weeks on site" indicator from postedAt + daysOnSite to flag stale inventory

Used-Car & Dealer Intelligence

• Pull every Cars & Vehicles listing across UK, AU, and ZA on a single daily run, segmented by sellerType
• Mileage, year, transmission, fuel type, body type, make, model — already broken out under attributes for direct CSV column mapping
• Identify dealers running aged stock by joining sellerName + postedAt over a 30-day window
• Spot pricing anomalies (private listings 20%+ below dealer median for the same car) for arbitrage

Lead Generation & Outreach

• Capture seller name and (with includePhone on) phone number for direct dealer or seller outreach (best on ZA and AU cars)
• Filter by sellerType: private to find homeowners posting "wanted" ads in the For Sale category
• Build region-specific seller directories across the UK and South Africa from the Jobs, Pets, or For Sale catalogues

Competitive & Reseller Intelligence

• Watch a competitor's seller name across the UK For Sale category to track their full inventory
• Find arbitrage opportunities — low-price UK listings of items that resell at higher prices on eBay or Vinted
• Monitor new listings in a category every 6 hours by combining sortBy: Most Recent with listingStartDate
• Identify high-volume sellers (more than 50 active ads) for B2B prospecting

Journalism & Public-Interest Research

• Map UK rental-market data across regional postcodes (Property category, beds/baths in attributes)
• Track Jobs-category postings by location to surface regional hiring trends
• Quantify second-hand market activity in cost-of-living stories using listing counts and median asking prices

Getting Started

Simple — UK keyword search

{
    "searchKeyword": "iPhone 15",
    "region": "uk",
    "maxResults": 50
}

South Africa cars with a price range

{
    "searchKeyword": "Toyota Hilux",
    "region": "za",
    "category": "cars-vehicles",
    "minPrice": 100000,
    "maxPrice": 300000,
    "sortBy": "price_low_high",
    "maxResults": 200
}

UK full-filter run with paste-mode URLs

{
    "startUrls": [
        "https://www.gumtree.com/cars/uk/london",
        "https://www.gumtree.com/flats-houses/uk/manchester?max_price=1200"
    ],
    "searchKeyword": "Ford Focus",
    "region": "uk",
    "location": "Birmingham",
    "category": "cars-vehicles",
    "sortBy": "most_recent",
    "minPrice": 2000,
    "maxPrice": 8000,
    "includeListingDetails": true,
    "includePhone": true,
    "maxResults": 500
}

Daily incremental monitoring — UK new listings only

Run this every 24 hours with yesterday's date — pagination stops the moment Gumtree returns an ad older than the cutoff, so you only pay for new posts:

{
    "searchKeyword": "MacBook Pro",
    "region": "uk",
    "category": "for-sale",
    "sortBy": "most_recent",
    "listingStartDate": "2026-05-15",
    "maxResults": 0
}

Input Reference

What to Scrape

Parameter	Type	Default	Description
startUrls	URL[]	[]	Paste Gumtree search, category, or individual listing URLs. Works with gumtree.com (UK), gumtree.com.au (Australia), and gumtree.co.za (South Africa). Mix any combination — the region is detected per URL. Filters in the URL are kept as-is.
searchKeyword	string	""	Keyword to search across Gumtree (e.g. "iPhone 15", "Ford Focus", "2 bed flat"). Combined with the region, location, and category below. Leave blank to browse a whole category or region.
region	select	United Kingdom (gumtree.com)	Which Gumtree region to search when using the keyword/location/category fields. Options: United Kingdom (gumtree.com), Australia (gumtree.com.au), South Africa (gumtree.co.za). Ignored when URLs are pasted — the URL's domain is used instead.
location	string	""	City, town, area, or postcode prefix to narrow the search (e.g. "London", "Perth", "Cape Town", "SW1A"). Leave blank to search the whole region.
category	select	All Categories	Top-level category. Options: All Categories, Cars & Vehicles, Property (Houses & Flats), For Sale (Goods), Jobs, Pets, Community. Note: Australia is currently supported for Cars & Vehicles only; UK and South Africa support every listed category.

Filters

Parameter	Type	Default	Description
sortBy	select	Most Recent	Listing order. Options: Most Recent, Best Match (Relevance), Price: Low to High, Price: High to Low, Nearest First. "Most Recent" is best with the date filter — pagination stops once listings get too old.
minPrice	integer	null	Minimum price in the region's local currency (GBP / AUD / ZAR). Leave blank for no lower bound.
maxPrice	integer	null	Maximum price in the region's local currency (GBP / AUD / ZAR). Leave blank for no upper bound.
listingStartDate	string	""	Only return listings posted on or after this date (YYYY-MM-DD). With sort = Most Recent, the actor stops paginating as soon as it crosses the cutoff.

Output Detail & Limits

Parameter	Type	Default	Description
maxResults	integer	100	Maximum listings to return across all URLs and searches. Set to 0 for unlimited (an internal cap of 50,000 still applies). A single keyword/category search reaches roughly 1,800 rows due to Gumtree's pagination depth — split into multiple startUrls to scale beyond that. The run overshoots the final page rather than mid-page-trimming.
includeListingDetails	boolean	true	Open each listing's detail page for full description, all images, structured attributes (beds/baths, mileage/year, etc.), and seller name. Disable for faster, cheaper runs that only return what's on the search-result cards.
includePhone	boolean	false	Include the seller's phone number when Gumtree publishes it in plain sight. Reliable on South Africa and on Australian car listings where the dealer has exposed digits. United Kingdom numbers stay behind a click-to-reveal step, so UK rows always report phone: null. Off by default to keep runs fast.

Output

Every listing is a flat row with the same 27 fields across UK, AU, and ZA. Here's a representative South African result (Cars & Vehicles, full details enabled):

{
    "listingId": "10013564879631010343222609",
    "shortId": "1356487963",
    "url": "https://www.gumtree.co.za/a-cars-bakkies/durbanville/2008-toyota-rav4-2-0-vx-4x4/10013564879631010343222609",
    "region": "za",
    "title": "2008 Toyota RAV4 2.0 VX 4x4",
    "description": "2008 Toyota RAV4 D4D VX 4WD Manual. 259,000 km. Service history. Black leather interior. Aircon, power steering, central locking, electric windows, alloy wheels...",
    "price": 148700,
    "priceRaw": "R 148,700",
    "currency": "ZAR",
    "priceType": "fixed",
    "category": "Western Cape > Northern Suburbs > Used Automotive Vehicles for Sale > Cars & Bakkies",
    "categorySlug": "9077",
    "location": "Durbanville",
    "postcode": null,
    "latitude": -33.82753,
    "longitude": 18.65268,
    "postedAt": "2026-05-15T09:38:28Z",
    "daysOnSite": 0,
    "sellerName": "Value Auto",
    "sellerType": "business",
    "phone": "0826001533",
    "images": [
        "https://gms.gumtree.co.za/v2/images/za_ads_103432226_260508_69fdf9f4ad21e52aa17698eb?size=l"
    ],
    "imageCount": 1,
    "attributes": {
        "caryear": 2008,
        "cartransmission": "Manual",
        "forsaleby": "Dealer",
        "fueltype": "Petrol",
        "carbodytype": "SUV",
        "carmake": "Toyota",
        "carmodel": "RAV-4",
        "carmileageinkms": 259000,
        "cardrivetype": "4x4"
    },
    "featured": false,
    "urgent": false,
    "scrapedAt": "2026-05-16T08:45:01Z"
}

Core Identifiers

Field	Type	Description
listingId	string	Unique Gumtree listing ID. Stable per region.
shortId	string	Short numeric ID where Gumtree exposes one (ZA only). null on UK and AU.
url	string	Canonical listing URL on the region's domain.
region	string	uk, au, or za.
scrapedAt	string	ISO 8601 UTC timestamp of when the row was captured.

Listing Content

Field	Type	Description
title	string	Listing headline as posted by the seller.
description	string	Full listing description from the detail page (UK + ZA) or from the search response (AU cars). null on UK / ZA when includeListingDetails is off.
category	string	Human-readable category. On UK + ZA detail pages the full breadcrumb (e.g. "Cars & Vehicles > Cars for Sale"); otherwise the top-level category label.
categorySlug	string	URL-safe category slug or numeric category ID.
images	string[]	Every full-resolution image URL on the listing.
imageCount	integer	Number of images in the listing.

Pricing

Field	Type	Description
price	integer	Numeric price in the region's local currency (whole units). null for free / contact-for-price / swap listings.
priceRaw	string	Formatted price as it appears on the site (e.g. "£1,295", "R 148,700", "$5,900").
currency	string	ISO 4217 currency code: GBP, AUD, or ZAR.
priceType	string	fixed, free, swap-trade, contact, or negotiable.

Location & Geo

Field	Type	Description
location	string	Free-text location label (city, suburb, or area).
postcode	string	Postcode where Gumtree publishes it (mostly ZA detail pages).
latitude	number	Listing latitude where Gumtree publishes geo data on the detail page.
longitude	number	Listing longitude where Gumtree publishes geo data on the detail page.

Posted Date

Field	Type	Description
postedAt	string	ISO 8601 timestamp of when the listing went live (UTC).
daysOnSite	integer	Whole days between postedAt and scrapedAt.

Seller

Field	Type	Description
sellerName	string	Display name of the seller or dealership.
sellerType	string	business (dealer / shop) or private (individual).
phone	string	Seller's published phone number. Populated when includePhone is on and the seller has the digits in plain sight (typical on South Africa and Australian car listings). United Kingdom numbers stay behind Gumtree's click-to-reveal step and remain null.

Attributes & Flags

Field	Type	Description
attributes	object	Free-form key-value map of listing-specific fields — carmake, carmodel, caryear, carmileageinkms, cartransmission, fueltype, beds, baths, condition, etc. Keys vary by category.
featured	boolean	True when the seller has paid for "Featured" placement.
urgent	boolean	True when the listing carries the "Urgent" badge.

Tips for Best Results

• Daily monitoring? Set listingStartDate to yesterday. With sortBy: Most Recent, pagination stops the moment Gumtree returns an ad older than the cutoff — a 24-hour delta run typically costs 5–10% of a full crawl on the same query.
• Australia coverage focuses on Cars & Vehicles. UK and South Africa support every category; AU runs default to Cars. If you pick another AU category the run finishes with an actionable hint to either switch region or switch to Cars & Vehicles.
• Toggle details for speed vs. depth. Turn off includeListingDetails for fast price-only sweeps (titles, prices, locations from search cards). Turn it on for full descriptions, image galleries, structured attributes, and seller names.
• UK locations accept city names and postcode prefixes. London, Manchester, Birmingham, SW1A resolve to the right region slug. Unknown inputs fall back to a national UK search so the run still returns results.
• For runs over ~1,800 listings per query, split into multiple startUrls. Gumtree's pagination tops out around 60 pages per search; use two or three category or location URLs in startUrls instead of pushing maxResults higher on a single search.
• Use sortBy: Most Recent + listingStartDate for incremental crawls. Together they make daily, hourly, or even 15-minute delta runs cheap — only new ads are paginated and charged.
• Filter by sellerType downstream. business vs private is captured per row, so a single run can power both a "dealer inventory" report and a "private seller leads" report without re-crawling.
• Start with maxResults: 50–100 on a new query. Confirm titles, prices, and attributes match what you expect, then scale up. Set maxResults: 0 for the full 50,000-listing cap.

Pricing

$1.50 per 1,000 listings — pay-per-result. You only pay for listings returned to your dataset; there are no compute, run-time, or storage charges from this actor.

Listings	Cost
100	$0.15
1,000	$1.50
10,000	$15.00
100,000	$150.00

A "result" is any listing row in the output dataset. Apify platform fees (account plan, storage) may apply separately.

Integrations

Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via:

• Zapier / Make / n8n — workflow automation
• Google Sheets — direct spreadsheet export
• Slack / Email — notifications on new results
• Webhooks — trigger custom APIs on run completion
• Apify API — full programmatic access

Legal & Ethical Use

This actor extracts publicly visible classified listings for legitimate market research, competitive intelligence, and lead-generation use cases. Users are responsible for complying with applicable laws, Gumtree's Terms of Service, and the GDPR / POPIA / Australian Privacy Act rules that apply in each country. Do not use extracted data for spam, harassment, scraping at volumes that overwhelm the site, or any illegal purpose. Treat seller names, phone numbers, and personal details as personal data — store and process them accordingly.