🚗 Gumtree Cars & Vans Scraper

Want to find the perfect used car or van, or analyze the UK automotive market? This scraper makes it super easy!

Paste an input_url from your browser once you've already filtered on Gumtree, or use structured filters (make, model, price, mileage, year, fuel, body, transmission, etc.) — structured filters work better for AI agents. When input_url is set it overrides the filters. Either way, you get up to 1000 used car or van listings from gumtree.com with pricing, specs, and location as CSV or JSON.

💡 Perfect for...

• Car & Van Buyers: Monitor the market for the best deals on your next vehicle in the UK.
• Dealerships: Keep an eye on competitors' pricing and inventory to stay competitive.
• Market Research: Analyze trends in the UK used car and van market (average prices, popular models, mileage vs. price).
• Data Analysts: Download clean, structured data for visualizations, dashboards, or predictive pricing models.
• 🤖 AI Agents: Power your autonomous agents with real-time Gumtree listings. Perfect for OpenClaw workflows and bots tracking specific vehicles.
• 📚 RAG Systems: Feed detailed vehicle specifications and pricing into Retrieval-Augmented Generation pipelines to answer complex queries about the automotive market.
• 🔗 AI Workflows: Integrate seamlessly with LangChain, AutoGPT, CrewAI, and other AI frameworks that need structured automotive data.

✨ Why you'll love this scraper

• 🔗 Input URL or Filters: Paste a Gumtree search URL (input_url) if you already filtered in the browser, or use structured filters (better for AI agents). input_url always wins when set.
• 🎯 Website-Matched Filters: Make, model, fuel, body, transmission, colour, seller, price, mileage, and year use the same option values as gumtree.com.
• 🚚 Cars and Vans: Switch vehicle_type between used cars and used vans.
• ⚙️ Rich Listings: Extracts price, year, mileage, fuel, body, transmission, colour, seller type, location, and images out of the box.
• ⏱️ Sorting Options: Traverse results by relevance, newest, price, or distance — same sort values as on the site.
• 🇬🇧 Built for the UK: Optional postcode/location + distance (use Nationwide for countrywide results).

📦 What's inside the data?

For every single listing, you will get:

• Core Details: id, title, url, image, images, photo_count, short_description
• Technical Specs: make, model, fuel_type, body_type, transmission, colour, doors, seats, engine_size, mileage, year, registration
• Pricing: price, price_text
• Seller & Place: seller_type, seller_id, pro_account, location, postcode, distance, distance_miles
• Context: vehicle_type (cars / vans), posted_date, featured, urgent, status

🛠️ Sort options

You can tell the scraper what order to read the listings in using the sort_by parameter (same values as Gumtree):

• relevance – Most relevant first
• date – Most recent first (default)
• price_lowest_first – Price: Low to High
• price_highest_first – Price: High to Low
• distance – Nearest first

🚀 Quick start

Option A — Input URL

1. Open Gumtree cars or vans, apply filters in the browser, copy the results URL — ideally https://www.gumtree.com/cars-vans-motorbikes/cars/... or /cars-vans-motorbikes/vans/....
2. Paste it into input_url.
3. Set max_cars and click Start.

Option B — Structured filters (better for AI agents)

1. Leave input_url empty.
2. Choose Used cars or Used vans.
3. Pick make/model and optional filters from the dropdowns (same lists as on Gumtree).
4. Optionally set search_location + distance (Nationwide = 1000).
5. Choose sort_by, set max_cars (up to 1000).
6. Click Start and export CSV, Excel, or JSON when done.

---

Tech details for developers 🧑‍💻

Input Example (structured filters):

{
  "vehicle_type": "cars",
  "make": "bmw",
  "model": "bmw::3-series",
  "max_price": "15000",
  "fuel_type": "diesel",
  "transmission": "automatic",
  "sort_by": "date",
  "max_cars": 100
}

Input Example (URL override):

{
  "input_url": "https://www.gumtree.com/cars-vans-motorbikes/cars/bmw/3-series?max_price=15000&vehicle_fuel_type=diesel&sort=date",
  "max_cars": 500
}

Input Example (used vans):

{
  "vehicle_type": "vans",
  "make": "ford",
  "max_price": "10000",
  "sort_by": "date",
  "max_cars": 100
}

Output Example:

{
  "id": 1515065112,
  "title": "2015 BMW 3 Series 330d Luxury 4dr Step Auto SALOON Diesel Automatic",
  "url": "https://www.gumtree.com/p/bmw/2015-bmw-3-series-330d-luxury-4dr-step-auto-saloon-diesel-automatic/1515065112",
  "image": "https://img.gumtree.com/ePR8PyKf84wPHx7_RYmEag/dea8977a64724762a7_db953b189da8/86",
  "make": "BMW",
  "model": "3 SERIES",
  "year": 2016,
  "mileage": 90830,
  "price": 8495,
  "price_text": "£8,495.00",
  "fuel_type": "Diesel",
  "body_type": "Saloon",
  "transmission": "Automatic",
  "colour": "Black",
  "registration": "YA16YEV",
  "seller_type": "Trade",
  "location": "Nelson, Lancashire",
  "vehicle_type": "cars",
  "posted_date": "1 day ago"
}

📋 Input reference (detailed)

Parameter	Type	Required	Default	Description
input_url	string	No	—	Paste a Gumtree cars/vans URL; overrides all filters below when set. Leave empty to use filters (better for AI agents). Prefer `/cars-vans-motorbikes/cars
vehicle_type	string enum	No	cars	cars (Used cars) or vans (Used vans).
make	string enum	No	any	Vehicle make from Gumtree (e.g. bmw, ford, volkswagen).
model	string enum	No	any	Make + model as make::slug (e.g. bmw::3-series, ford::transit). Pick a row that matches your Make.
search_location	string	No	—	Optional free-text UK place or postcode Gumtree understands (e.g. london, manchester, SW1A1AA). Not a fixed keyword list; leave empty for nationwide. Place names work best with Make = Any.
distance	string enum	No	any	Search radius from location. 1000 = Nationwide.
min_price / max_price	string enum	No	any	Price ladder values from Gumtree.
min_mileage / max_mileage	string enum	No	any	Mileage ladder values from Gumtree.
min_year / max_year	string enum	No	any	Registration year ladder from Gumtree.
fuel_type	string enum	No	any	Site fuel values (e.g. diesel, petrol, electric, hybrid_electric).
body_type	string enum	No	any	Body type from Gumtree.
transmission	string enum	No	any	e.g. automatic, manual.
colour	string enum	No	any	Exterior colour from Gumtree.
seller_type	string enum	No	any	e.g. trade, private.
sort_by	string enum	No	date	Result order (see sort options above).
max_cars	integer	No	50	Maximum listings to return (1–1000).

Notes on filters

• Prefer exact enum strings from the Apify input dropdowns (same values as gumtree.com).
• model uses make::slug (double colon), e.g. bmw::3-series.
• Make = Any (cars): Gumtree’s /cars page is only a make picker. The actor uses /cars-vans-motorbikes/cars/uk/uk for nationwide all-make results (or /cars/uk/{place} when a location is set). Vans already work without a make.
• Prefer /cars-vans-motorbikes/cars/{make}/... or /cars-vans-motorbikes/vans/... URLs when pasting input_url.
• search_location is free text (city/town/postcode), not a controlled vocabulary. Place names work best with Make = Any; postcodes work reliably when a make is selected. Unknown places usually return 0 results.
• Gumtree SRPs typically expose up to ~50 pages (~30 ads/page).
• input_url always wins over filters when provided.