UK, AU & ZA Classified Ads Listings — Gumtree
ECOMMERCEREAL ESTATE
Gumtree Classified Ads & Second-Hand Listings Scraper
Classified ad and second-hand listings from Gumtree UK (gumtree.com), Australia (gumtree.com.au), and South Africa (gumtree.co.za). Search by keyword, browse a category, or supply listing URLs. Returns title, price, location, description, images, seller name and type, category attributes, and date posted.
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.
- All three regions: reliable access to every Gumtree domain, with 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.