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 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.

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)
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
  },
  "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.