Gumtree Cars & Vans Scraper

🚗 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. Type a make and model, plus any optional filters (same values 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	No	cars	cars (Used cars) or vans (Used vans).
make	string	No	any	Vehicle make from Gumtree (e.g. bmw, ford, volkswagen).
model	string	No	any	Make + model as make::slug (e.g. bmw::3-series, ford::transit). A model name such as 3 Series also works when Make is set.
search_location	string	No	—	Optional UK postcode or location (e.g. SW1A1AA, london).
distance	string	No	any	Search radius from location. 1000 = Nationwide.
min_price / max_price	string	No	any	Price ladder values from Gumtree.
min_mileage / max_mileage	string	No	any	Mileage ladder values from Gumtree.
min_year / max_year	string	No	any	Registration year ladder from Gumtree.
fuel_type	string	No	any	Site fuel values (e.g. diesel, petrol, electric, hybrid_electric).
body_type	string	No	any	Body type from Gumtree.
transmission	string	No	any	e.g. automatic, manual.
colour	string	No	any	Exterior colour from Gumtree.
seller_type	string	No	any	e.g. trade, private.
sort_by	string	No	date	Result order (see sort options above).
max_cars	integer	No	50	Maximum listings to return (1–1000).

Notes on filters

• Make, model, fuel, and the other filters accept the short site value (bmw, petrol) or the label (BMW, Petrol).
• model uses make::slug (double colon), e.g. bmw::3-series.
• Prefer /cars-vans-motorbikes/cars/ or /cars-vans-motorbikes/vans/ URLs. Generic /search?... URLs are often blocked.
• Gumtree SRPs typically expose up to ~50 pages (~30 ads/page).
• input_url always wins over filters when provided.

🔧 Custom scrapers and agents

If you need a custom web scraper, or custom AI agents and workflows, contact me through tuik.ai. We help businesses cut costs and time by up to 10x.