
Gumtree Scraper
hipersoft/gumtree-scraper
Scrape UK classified ads from Gumtree — cars, property, jobs, pets, for-sale items and more. Search by keyword, category and location, or paste ad URLs, and export one clean row per listing: title, price, location, attributes, image, category, ad ID and URL as JSON, CSV or Excel.
Total users
2Monthly users
1Total runs
56Per item scraped
$0.003Last rebuilt
Oct 26, 2026Overview
Scrape UK classified ads from Gumtree into clean, structured JSON, CSV, Excel or XML. Search by keyword, category and location — or paste specific ad URLs — and the Gumtree Scraper returns one tidy row per listing: title, price, location, attributes, image, category, ad ID and listing URL. Perfect for market research, price monitoring, comparables, deal-hunting and lead generation across cars, property, jobs, pets and everything Gumtree sells.
Whether you are tracking used car prices, watching the property to rent market, sourcing for-sale bargains, or building a dataset of local classified ads, this actor turns Gumtree search pages into a ready-to-use spreadsheet in minutes.
What does the Gumtree Scraper do?
This actor turns Gumtree search results into a structured dataset. Give it one or more search keywords, choose a category (or search all categories), optionally set a location, and it walks every page of results and collects each ad with clean fields. Because different categories show different details (a car lists year, mileage, fuel and engine size; a flat lists bedrooms and price; a phone lists model and condition), the actor captures those extra details in a flexible attributes field so it works across every Gumtree category without configuration.
Need the full ad? Turn on Fetch full ad details (or paste Ad URLs directly) and the scraper opens each ad's own page to collect the full description, complete image gallery, detailed attributes and posted date.
What data can you get?
Per ad (from search results):
| Field | Description |
|---|---|
adId |
Gumtree ad reference number. |
title |
Ad title. |
price |
Price as a number, when shown. |
priceText |
The price exactly as displayed (e.g. £2,250). |
currency |
Currency code (GBP), when a price is shown. |
location |
The ad's location (town, county). |
attributes |
Category-specific details as a list (e.g. for a car: year, mileage, seller type, fuel, engine size). |
image |
Main ad image URL, when present. |
category |
The category the ad was searched in. |
query |
The search keyword the ad was found with. |
url |
Link to the ad's page on Gumtree. |
collectedAt |
Timestamp when the row was collected. |
Extra fields when Fetch full ad details is on (or when using Ad URLs):
| Field | Description |
|---|---|
description |
Full ad description text. |
images |
Full image gallery (list of image URLs). |
attributes |
Detailed label→value attributes from the ad page. |
postedDate |
When the ad was posted, when available. |
Use cases
- Used car research — track make, model, year, mileage and asking prices across the UK.
- Property monitoring — follow flats and houses to rent or for sale by area and price band.
- Deal hunting — surface the cheap listings and spot the cheapest ads before anyone else.
- Price monitoring — watch asking prices and new listings over time on a schedule.
- Comparables & valuation — pull comparable ads by category, location and price band.
- Lead generation — build lists of offers and sellers in a category for outreach.
- Dashboards & automation — feed clean, structured classifieds data into your own reports and pipelines.
How to use the Gumtree Scraper
- Add Gumtree Scraper to your Apify account and open its input.
- Enter one or more Search keywords (e.g.
bmw,iphone,sofa). - Pick a Category (or leave it on All categories) and optionally set a Location such as
londonormanchester. - Set Max items per keyword and the overall Max items cap.
- (Optional) Turn on Fetch full ad details for descriptions and image galleries, or paste Ad URLs to enrich specific ads.
- Click Run and export the results as JSON, CSV, Excel or XML.
Input example
{
"searchQueries": ["bmw"],
"category": "cars-vans-motorbikes",
"location": "london",
"maxItemsPerQuery": 100,
"maxItems": 0,
"fetchDetails": false
}
| Field | Description |
|---|---|
searchQueries |
Keywords to search for. Each is searched and paginated separately. |
category |
Restrict to a Gumtree category, or all for everything. |
location |
Optional UK location filter (e.g. london, manchester). |
productUrls |
Optional Gumtree ad URLs to fetch full details for directly. |
fetchDetails |
Also open each ad's page for description, gallery and posted date. |
maxItemsPerQuery |
Cap the ads collected per keyword. 0 = no limit. |
maxItems |
Overall cap across all keywords. 0 = no limit. |
maxConcurrency |
How many ad detail pages to fetch in parallel. |
Output example
One flat JSON row per ad, ready to export to CSV, Excel, JSON or XML.
{
"adId": "1802312333",
"title": "2016 BMW 320 GT",
"price": 5995,
"priceText": "£5,995",
"currency": "GBP",
"location": "Barry, Vale of Glamorgan",
"attributes": ["2015", "140,916 miles", "Trade", "Diesel", "1,995 cc"],
"image": "https://img.gumtree.com/....../86",
"category": "cars-vans-motorbikes",
"query": "bmw",
"url": "https://www.gumtree.com/p/bmw/2016-bmw-320-gt/1802312333",
"collectedAt": "2026-09-10T05:13:34.301Z"
}
Frequently asked questions
Which categories are covered? All of them — cars, vans & motorbikes, for-sale items, property, flats & houses, jobs, pets, business & services and community. Pick one category or search across everything.
Can I search a specific town or city?
Yes. Set the Location field to a UK place such as london, manchester or birmingham to narrow results.
Can I get the full ad description and all photos? Yes. Turn on Fetch full ad details, or paste specific Ad URLs, to collect the full description, complete image gallery, detailed attributes and posted date.
How do I find the cheapest deals?
Export to CSV or Excel and sort by the price column, or filter by a price band — the numeric price field makes it easy to rank the cheap listings first.
What export formats are supported? JSON, CSV, Excel and XML — plus the Apify API and integrations for automation and scheduling.
Related scrapers
- SS.lv Latvia Classifieds Scraper
- Property24 Scraper — South Africa Property Listings
- Rightmove Scraper
- eBay Scraper
Input
| Field | Type | Description |
|---|---|---|
searchQueriesSearch keywords | array | One or more keywords to search Gumtree for (e.g. 'bmw', 'iphone', 'sofa'). Each keyword is searched separately and paginated automatically. Combine with Category and Location to narrow results. Leave empty if you only want to browse a whole Category/Location, |
categoryCategory | string · all, cars-vans-motorbikes, for-sale, property, flats-houses, jobs… | Restrict the search to a Gumtree category. Choose 'All categories' to search everything. Default: "all" |
locationLocation | string | Optional. Restrict results to a UK location, e.g. 'london', 'manchester', 'birmingham'. Leave empty to search the whole UK. |
productUrlsAd URLs | array | Optional. Paste one or more Gumtree ad page URLs to fetch their full details directly (title, price, description, full image gallery, attributes and posted date). Use this when you already have specific ads you want to enrich. |
fetchDetailsFetch full ad details | boolean | Also open each ad's own page to collect the full description, image gallery, detailed attributes and posted date. This makes runs slower but returns richer data. Default: false |
maxItemsPerQueryMax items per keyword | integer | Maximum number of ads to collect for each search keyword (0 = no limit). Default: 100 |
maxItemsMax items (overall) | integer | Overall cap across all keywords (0 = no limit; collect everything the searches return). Default: 0 |
maxConcurrencyMax concurrency | integer | How many ad detail pages to fetch in parallel when fetching full details or ad URLs. Default: 5 |
proxyConfigurationProxy configuration | object | Optional. Proxy is not required — the scraper runs fine on a direct connection. Enable a proxy only if you want to route requests through specific IPs. |
API
curl -X POST "https://api.apify.com/v2/acts/hipersoft~gumtree-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"searchQueries": [
"bmw"
],
"location": ""
}'from apify_client import ApifyClient
client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("hipersoft/gumtree-scraper").call(run_input={
"searchQueries": [
"bmw"
],
"location": ""
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('hipersoft/gumtree-scraper').call({
"searchQueries": [
"bmw"
],
"location": ""
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);Pricing
| Event | Price | Paid plans from |
|---|---|---|
| Item scraped Charged once for each listing/ad successfully scraped and pushed to the dataset. | $0.003 | $0.0015 |
You pay only for what the run returns. Set a maximum cost per run and it stops cleanly at that limit.
Related scrapers
Dribbble Shots Scraper
Scrape public design shots from Dribbble: title, high-res image, tags, likes, views and designer credit. Filter by category or sort, export JSON, CSV or Excel.
359 runs · 5 users · $0.003 / shot scrapedComputrabajo Scraper
Scrape Computrabajo job listings across Latin America (Mexico, Colombia, Argentina, Chile, Peru and more): title, company, location, salary, posted date and apply URL. Filter by country and keyword. No setup.
206 runs · 4 users · $0.002 / listing scrapedKraken Market Data Scraper
Fetch Kraken spot market data in bulk: ticker stats (ask, bid, last, 24h high/low/volume/vwap), OHLC candles for any interval, order book depth (top bids/asks), and tradable pair metadata. Fast, clean and cheap.
165 runs · 4 users · $0.001 / pair scrapedBayt Scraper
Scrape Bayt.com job listings across the Middle East (UAE, Saudi Arabia, Egypt, Qatar and more): title, company, location, posted date and apply URL. Filter by country and keyword.
134 runs · 4 users · $0.003 / job scrapedGitHub Scraper
Search GitHub and scrape repositories (stars, forks, language, topics, license, dates) or user profiles (name, company, location, bio, followers, public email, repos). Uses the GitHub REST API; optional token for higher rate limits. For developer lead generation, OSS research and recruiting.
131 runs · 7 users · $0.0008 / item scrapedHacker News Scraper
Scrape Hacker News stories, comments, Ask HN, Show HN, jobs and polls by keyword, points, comments and date range. Sort by relevance or newest. Title, URL, author, points, comment count, text and HN link. Fast clean HTTP via the HN Algolia API, no setup.
130 runs · 2 users · $0.004 / item scrapedSend the site and the fields. We build it and you get it first.