AutoTrader UK — Gumtree UK Car Listings Scraper

Scrape used car listings from Gumtree UK (gumtree.com) — the UK's largest free classifieds site. Search by keyword, make, model, or location. Extracts car make/model, year, price, mileage, condition, seller info, images, and listing URLs. No proxy, no auth required.

What this actor does

• Two modes: free-text search (e.g. "ford focus london") or structured byMakeModel (make + optional model)
• Sort options: newest first, cheapest first, most expensive first, or best match
• Location filter: narrow results by UK city, postcode area, or region
• Rich data: extracts schema.org JSON-LD from individual listing pages for full vehicle details
• Empty fields are omitted — no nulls in output

Output per listing

Field	Description
listingId	Gumtree listing ID
name	Full listing title
description	Listing description (up to 500 chars)
listingUrl	Direct URL to the listing
brand	Vehicle make (e.g. Ford)
model	Vehicle model (e.g. Focus ST)
vehicleModelDate	Year of manufacture
price	Asking price (number)
priceCurrency	Always GBP
availability	Availability status (e.g. InStock)
mileage	Odometer reading (integer)
mileageUnit	Unit code (usually SMI = statute miles)
condition	Used / New / Refurbished
imageUrl	Primary listing image URL
imageCount	Total number of images
location	Seller location
isTrade	true if seller is a dealer
isDelivery	true if delivery available
age	Listing age string (e.g. "2 days ago")
recordType	Always carListing
sourceUrl	URL the record was scraped from
scrapedAt	ISO 8601 timestamp

Input

Field	Type	Default	Description
mode	string	search	search (free-text) or byMakeModel (structured)
searchQuery	string	ford focus	Free-text query (mode=search)
make	string	–	Vehicle make, lowercase (mode=byMakeModel), e.g. ford
model	string	–	Vehicle model, lowercase (mode=byMakeModel), e.g. focus
location	string	–	UK location/postcode to narrow results, e.g. london, SW1
sortOrder	string	date	date / price_asc / price_desc / relevance
maxItems	integer	30	Maximum records to emit (1–500)

Example: free-text search

{
  "mode": "search",
  "searchQuery": "bmw 3 series diesel 2020",
  "location": "manchester",
  "sortOrder": "price_asc",
  "maxItems": 50
}

Example: structured search by make and model

{
  "mode": "byMakeModel",
  "make": "volkswagen",
  "model": "golf",
  "sortOrder": "date",
  "maxItems": 30
}

Use cases

• Used car price research — compare asking prices across UK regions for a specific make/model
• Market intelligence — track listing volumes, price trends, and average mileage
• Lead generation — monitor new listings for specific vehicles as they appear
• Data aggregation — combine Gumtree data with other UK car sources for comprehensive market views
• Price comparison — find the cheapest listings for a given specification
• Dealer analysis — identify trade vs private sellers in a given area

FAQ

What is Gumtree? Gumtree is the UK's largest free classifieds website, operated by eBay. It lists millions of used cars, vans, and motorbikes from private sellers and dealers across the UK.

Do I need a proxy or API key? No. Gumtree's public listing pages are accessible without authentication. The actor uses standard HTTP requests with no proxy or paid add-ons required.

How many listings can I get? Up to 500 per run (configurable via maxItems). Gumtree paginates results — the actor follows pagination automatically.

What data comes from individual listing pages? The actor fetches each listing page to extract schema.org JSON-LD data, which includes make, model, year, price, mileage, condition, images, and availability — richer than search snippets alone.

What does isTrade mean? true means the seller is a registered car dealer; false means a private seller.

Why might some fields be missing? Gumtree listings are user-generated. Not all sellers fill in make, mileage, or year — those fields are omitted from records where the data is absent.

What's the scrapedAt field? An ISO 8601 UTC timestamp indicating when the record was extracted.

Can I filter by price range? Use sortOrder: "price_asc" to see cheapest listings first, then limit with maxItems. For a strict price filter, post-process the output.