Gumtree Scraper

Scrape listings from Gumtree UK (gumtree.com), Australia (gumtree.com.au), and South Africa (gumtree.co.za). Search by keyword, browse by category URL, or supply start URLs directly. Extracts title, price, description, location, images, seller info, and more from search results and individual listing pages.

What you get

Each result contains:

Field	Description
listing_id	Unique Gumtree listing ID
title	Listing title
price	Price as shown on Gumtree
location	Seller location / area
description_short	Short description from search card
description	Full listing description from the detail page
listing_url	Direct link to the listing
image_url	Primary listing image URL
images	All image URLs (up to 10, space-separated)
seller_name	Seller display name
seller_type	Seller type (e.g. Private Seller, Trade Seller)
attributes	Key-value listing attributes (e.g. Make=Apple; Model=MacBook)
breadcrumb	Category breadcrumb path
date_posted	When the listing was posted
site	Gumtree regional site (com, com.au, co.za)
scraped_at	ISO 8601 timestamp of collection

Input

Option A — Keyword search (simplest)

{
  "searchQuery": "laptop",
  "site": "com",
  "maxItems": 100
}

site values: com (UK), com.au (Australia), co.za (South Africa). Defaults to com.

Optionally add category to narrow the search:

{
  "searchQuery": "macbook",
  "site": "com",
  "category": "laptops-computers-software",
  "maxItems": 50
}

Option B — Start URLs

Supply Gumtree search, category, or listing URLs directly. Supports all three regional domains.

{
  "startUrls": [
    { "url": "https://www.gumtree.com/search?search_category=all&q=sofa" },
    { "url": "https://www.gumtree.com/furniture/uk/i.html" }
  ],
  "maxItems": 200
}

Input fields reference

Field	Type	Default	Description
startUrls	array	—	Gumtree URLs to scrape (overrides keyword search)
site	select	com	Target regional site: com, com.au, co.za
searchQuery	string	laptop	Keyword to search for (when no startUrls)
category	string	—	Category slug to filter search results
maxItems	integer	100	Maximum number of listings to collect

Usage notes

• Pagination: The scraper automatically follows next-page links to collect results across multiple pages.
• Rate: Concurrency is kept low (2 concurrent browsers) to avoid triggering anti-bot detection.
• Regional proxies: Residential proxies are used automatically for reliable access to all three Gumtree domains. No configuration needed.

Pricing

This actor uses pay-per-result pricing:

• Start fee: $0.10 per run
• Per result: $0.0015 per listing

A run collecting 500 listings costs approximately $0.85.