Gumtree UK Scraper — Listings, Prices, Seller Ratings & Reviews

Extract classified listings from gumtree.com across every vertical — motors, property, jobs, services, pets, community and the for-sale goods categories — with the full listing detail and the seller's aggregate rating, star distribution and reviews.

Search by category + location + keyword, or paste any Gumtree results or listing URL. The scraper walks result pages forward automatically and returns one clean record per listing.

What you get

Every listing record includes:

• Identity — id, url, title, categoryId, categoryName, vertical
• Price — price (number), priceText, currency
• Location — location, distance, plus latitude / longitude / postcode / area when detail enrichment is on
• Listing — shortDescription, full description, all images, imageCount, hasVideo, postedDate, status, featured / urgent / premium flags
• Attributes — the full structured attribute list (for cars: make, model, year, mileage, fuel type, transmission, and dozens more)
• Seller — seller.type (private / trade), seller.rating (0–5 average), seller.reviewCount, seller.ratingDistribution (count per star), individual seller.reviews, plus activity stats (postingSince, totalAdvertCount, lastActiveStatus)
• Seller phone — seller.phone, the full contact number, when Also reveal the seller's phone number is on

Seller ratings and reviews are published only on the listing page, so they are captured when Fetch full listing detail is enabled (default on). Turn it off for faster, cheaper results-only runs.

Seller phone numbers

Gumtree shows a seller's phone number only to signed-in visitors — everyone else sees it masked, as 0773041XXXX. Turn on Also reveal the seller's phone number and each listing carries the full number in seller.phone. Access for this is handled and cached securely for you, set up once and reused by every later run. It adds no extra request and no extra charge per listing — the number arrives in the detail fetch that already happens.

Not every seller publishes a number, so every record also carries seller.phoneStatus, and it always distinguishes the two:

seller.phoneStatus	Meaning
revealed	seller.phone holds the seller's full number
no-phone	Gumtree answered, and this seller published no number at all
not-requested	The option was off for this run
session-expired / refused	The number could not be read; re-run to renew access

seller.phoneMasked always carries the masked form Gumtree shows publicly, so nothing is lost either way. Phone numbers are personal data: collecting and using them is subject to UK GDPR and to Gumtree's terms, and that responsibility sits with you as the operator — keep usage lawful and proportionate.

Input

Field	Description
Search mode	search — build the query from filters below · url — paste your own Gumtree URLs
Category	Motors, Cars only, Property, Jobs, Services, Pets, Community, or All / For-sale goods
Location	Town, city or region (e.g. London, Manchester). Empty = all of the UK
Keyword	Free-text search (e.g. ford focus, iphone 15)
Sort	Most relevant · Most recent · Price low→high · Price high→low · Nearest
Min / Max price (GBP)	Narrow to a price band
Fetch full listing detail	Add description, map location and seller rating & reviews (default on)
Also reveal the seller's phone number	Return the seller's full phone number instead of Gumtree's masked form (default off; needs detail enrichment, which is switched on automatically)
Max listings / Max pages	Bound the run size
URLs	(URL mode) any gumtree.com results or listing URLs
Resume from run/dataset ID	Continue ONE interrupted crawl — listings already collected there are skipped
Incremental mode	For a search you run on a schedule: remembers the previous run itself and classifies every listing as NEW / UPDATED / UNCHANGED / REAPPEARED / EXPIRED instead of returning the same listings every time (default off)
State key	(Incremental mode, optional) label to isolate this search's state; auto-derived from the filters when empty
Also return UNCHANGED listings	(Incremental mode) include (and bill for) unchanged listings instead of suppressing them (default off)
Also return EXPIRED listings	(Incremental mode) include (and bill for) listings no longer found, once, then stop tracking them (default off)

Example input

{
  "mode": "search",
  "category": "cars",
  "location": "London",
  "minPrice": 5000,
  "maxPrice": 15000,
  "sortBy": "most_recent",
  "fetchDetails": true,
  "maxItems": 100
}

Output

Each listing is one dataset record. Example (illustrative values):

{
  "id": "1500000001",
  "url": "https://www.gumtree.com/p/ford/ford-focus-1-0-ecoboost/1500000001",
  "title": "Ford Focus 1.0 EcoBoost Zetec, 2018, Manual",
  "price": 7495.0,
  "priceText": "£7,495.00",
  "currency": "GBP",
  "categoryId": "10319",
  "vertical": "motors",
  "location": "Camden, London",
  "distance": "3 miles",
  "postedDate": "2 days ago",
  "shortDescription": "One owner, full service history, MOT until 2026 …",
  "description": "One owner from new, full Ford service history, two keys, recent …",
  "images": [
    "https://img.gumtree.com/aaaaaaaa/1111111111_2222222222/max800",
    "https://img.gumtree.com/aaaaaaaa/3333333333_4444444444/max800"
  ],
  "imageCount": 12,
  "latitude": 51.5390,
  "longitude": -0.1426,
  "postcode": "NW1 8QP",
  "attributes": [
    { "name": "Make", "value": "Ford", "key": "vehicle_make" },
    { "name": "Year", "value": "2018", "key": "vehicle_registration_year" },
    { "name": "Mileage", "value": "42,300", "key": "vehicle_mileage", "unit": "miles" },
    { "name": "Fuel type", "value": "Petrol", "key": "vehicle_fuel_type" }
  ],
  "detailFetched": true,
  "seller": {
    "name": "Jane D",
    "type": "private",
    "rating": 4.8,
    "reviewCount": 25,
    "ratingDistribution": { "1": 0, "2": 1, "3": 0, "4": 2, "5": 22 },
    "reviews": [
      { "rating": 5, "text": "Smooth sale, great communication.", "date": "2026-05-14" }
    ],
    "postingSince": "3 years",
    "totalAdvertCount": 8,
    "phone": "07700 900123",
    "phoneMasked": "0770090XXXX",
    "phoneStatus": "revealed"
  },
  "scrapedAt": "2026-07-06T10:00:00Z"
}

Resume & recurring updates (incremental mode)

Schedule this actor to run the same search daily (or on any cadence) with Incremental mode on, and each record additionally carries:

Field	Description
changeType	NEW · UPDATED · UNCHANGED · REAPPEARED · EXPIRED since the previous run of this search
changedFields	Which fields changed (only set for UPDATED)
firstSeenAt	When this listing was first collected under this state key
lastSeenAt	When this listing was last seen

By default, only NEW / UPDATED / REAPPEARED / EXPIRED listings are returned (and billed) — unchanged listings are suppressed so a recurring run only bills for what actually changed. Turn on Also return UNCHANGED listings or Also return EXPIRED listings to include those too (both are billed like any other row). EXPIRED rows are only emitted after a run that reached the natural end of results for every search — a capped or time-limited run never flags a listing as gone.

If a run skips detail enrichment for a listing purely because it was running low on time, that alone never counts as a change — only a real difference in the listing's own fields does.

Tips

• Sub-categories & complex filters: refine your search on gumtree.com in a browser, then paste the resulting URL in URL mode — every filter in the URL is honoured, and pagination continues from that page.
• Faster runs: turn Fetch full listing detail off to get the results-page fields only (seller rating fields are then left empty).
• Export anywhere: pipe results straight into Notion, Airtable or Linear via the optional MCP connectors, or download as JSON / CSV / Excel from the dataset.

FAQ

Does it cover the whole of the UK? Yes — leave Location empty for a national search, or set any town, city or region.

Are seller reviews included? Yes, where the seller has them. Each record carries the seller's average rating, the count per star, and individual review entries, alongside the seller's activity stats.

Which categories are supported? All of Gumtree's verticals — motors, property, jobs, services, pets, community and the for-sale goods categories — plus any sub-category via URL mode.

National (no location) searches: most verticals support them. For the Cars vertical the site itself no longer serves a nationwide first results page (it redirects to a browse hub that loads results in the browser), so pick a location there, or paste a gumtree.com URL in URL mode. If a first results page cannot be read at all, the run now fails with a clear message instead of returning zero rows.

Verification

• 2026-09-01: filter surface re-derived live. Server-side counts (searchResultAbundance): cars/London 9,383; q=bmw 712; q=electric 1,245; max_price=5000 3,188; min_price=20000 297; q=bmw&max_price=15000 657; nonsense keyword 0. Sort price_highest_first / price_lowest_first honored on the organic tail (featured ads stay pinned first). Category narrowing: for-sale UK 1,452,299 vs cars/London 9,383. URL mode: a live category URL and a live listing URL both returned real data (listing carried the full detail model and seller rating).