🚗 ParuVendu Auto Scraper

Want to find used cars on ParuVendu or analyze the French private + pro market? This scraper makes it super easy!

Paste an input_url from your browser once you've already filtered on ParuVendu, or use structured filters (make, model, location, price, fuel type, etc.) — structured filters work better for AI agents. When input_url is set it overrides the filters. Either way, you get up to 2000 car listings from the auto section only, with pricing, specs, and location as CSV or JSON.

💡 Perfect for...

• Car Buyers: Monitor deals from private sellers and small dealers across France.
• Dealerships: Track competitor inventory and pricing on ParuVendu.
• Market Research: Analyze French used-car supply by brand, city, mileage, and fuel.
• Data Analysts: Export clean structured data for dashboards and pricing models.
• 🤖 AI Agents: Power bots and OpenClaw workflows with real-time ParuVendu listings.
• 📚 RAG Systems: Feed vehicle specs and prices into retrieval pipelines.
• 🔗 AI Workflows: Plug into LangChain, AutoGPT, CrewAI, and similar stacks.

✨ Why you'll love this scraper

• 🔗 Input URL or Filters: Paste a ParuVendu 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.
• 🎯 Structured Filters: Search by make, model, city/radius, body type, price, mileage, year, fuel, and gearbox — no URL crafting.
• 🚗 Auto Only: Scoped to voiture d'occasion (ignores immobilier, seconde main, etc.).
• ⚙️ Rich Listings: Price, year, mileage, fuel, gearbox, location, and images from search cards.
• 🔎 Optional Deep Dive: Turn on enrich_details for extra specs (power, colour, seller, image gallery).
• ⏱️ Sorting Options: Newest, price, mileage, or listings with photos.

📦 What's inside the data?

For every single car listing, you will get:

• Core Details: id, title, url, image, photo_count
• Location: location, postal_code
• Technical Specs: make, model, fuel_type, gearbox, mileage, year
• Pricing & Seller: price, seller_type
• With enrich_details: power_hp, color, body_type, seller_name, images, …

🛠️ Sort options

Use the sort_by parameter:

• Most Recent – Newest listings first
• Lowest / Highest Price
• Lowest / Highest KM
• With Photo – Prefer ads that include photos

🚀 Quick start

Option A — Input URL

1. Open ParuVendu voiture d'occasion, apply filters in the browser, copy the results URL.
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. Set filters (e.g. make Renault, model Clio), optional location + radius, price / mileage / year / fuel.
3. Choose sort_by and max_cars (up to 2000).
4. (Optional) Enable enrich_details for full ad-page specs.
5. Click Start and export CSV, Excel, or JSON when done.

---

Tech details for developers 🧑‍💻

Input Example (filters)

{
  "make": "VVORE000",
  "model": "Clio",
  "location": "Paris",
  "radius_km": "50",
  "price_max": 10000,
  "energy": "ES",
  "sort_by": "Lowest Price",
  "max_cars": 100
}

Input Example (URL override)

{
  "input_url": "https://www.paruvendu.fr/voiture-occasion/renault/clio/",
  "max_cars": 100
}

Output Example

{
  "id": "1293356442A1KVVORECLI",
  "title": "Renault III (2) 1.5 DCI 70 DYNAMIQUE 5P EURO5",
  "url": "https://www.paruvendu.fr/a/voiture-occasion/renault/clio/1293356442A1KVVORECLI",
  "image": "https://cdn2.vroomiz.fr/uploads/advertcars/example.jpg",
  "price": 5490,
  "year": 2008,
  "mileage": 120000,
  "fuel_type": "Diesel",
  "gearbox": "Manuelle",
  "location": "Coignières (78310)",
  "postal_code": "78310",
  "photo_count": 8,
  "make": "RENAULT",
  "model": "Clio",
  "seller_type": "Professional"
}

📋 Input reference (detailed)

Parameter	Type	Required	Default	Description
input_url	string	No	—	Paste a ParuVendu search URL; overrides all filters below when set. Leave empty to use filters (better for AI agents).
make	string enum	No	any	Car brand, sourced live from ParuVendu's own affinage API (113 brands, e.g. VVORE000 = Renault, VVOBM000 = BMW, VVOME000 = Mercedes). Leave empty ("", Any) to search all brands. See full brand list below.
model	string	No	—	Model name (e.g. Clio, 208, Golf). Requires make.
location	string	No	—	City or place for geo search (e.g. Paris, Lyon, Marseille).
radius_km	string enum	No	"" (do not widen)	Search radius around location: 5, 15, 30, 50, 100. Ignored if location is empty.
body_type	string enum	No	any	Body category, using ParuVendu's own r1 site codes: TO Berline, 4X 4x4 - SUV, BR Break, CA Cabriolet, CO Coupé, MO Monospace, SO Véhicule de société, PU Pick-up.
price_min / price_max	integer	No	—	Price range in euros.
mileage_min / mileage_max	integer	No	—	Mileage range in km.
year_min / year_max	integer	No	—	First-registration year range.
energy	string enum	No	any	Fuel filter, using ParuVendu's own nrj site codes: ES Essence, DI Diesel, GP GPL ou GNL, BI BioEthanol, EL Electrique, HY Hybride (tous), HR Hybride rechargeable, MH Micro Hybride, HD Hydrogène, ZZ Autres.
gearbox	string enum	No	any	Transmission, using ParuVendu's own tr site codes: MA Manuelle, AU Automatique, SA Semi automatique, ZZ Autres.
sort_by	string enum	No	Most Recent	Result order (see sort options above).
max_cars	integer	Yes	50	How many listings to return (1–2000).
enrich_details	boolean	No	false	If true, fetch each ad page for richer fields (slower).
listing_urls	string[]	No	—	Direct ad URLs. If provided without search filters, only these URLs are scraped.

Notes on filters

• input_url always wins over filters when provided.
• This Actor only scrapes cars (voiture d'occasion), not the rest of ParuVendu.
• Each run returns at most max_cars listings (1–2000).
• Some ads show “à débattre” or promo text near the price — the numeric EUR value on the card is what we store.
• energy, gearbox, body_type, and make are applied on the ParuVendu search request itself (via the nrj, tr, r1, and r query params on ParuVendu's affinage search endpoint), not just filtered client-side after scraping — so the site does the heavy lifting and pagination reflects the real filtered result count. Older free-text values for energy/gearbox/body_type/make (e.g. essence, manual, berline, Renault) are still accepted for backward compatibility and are mapped to the new site codes automatically.
• model filtering uses ParuVendu's pretty /voiture-occasion/{make}/{model}/ path (ParuVendu doesn't support reliable model-code filtering via the affinage endpoint), so it requires make to be set.

🔤 Brand codes (make)

The make dropdown is generated from ParuVendu's own brand list (GET /auto-moto/listefo/default/affinage?origine=affinage&r=VVO00000), which returns 113 brands as { "lib": "Renault", "cod": "VVORE000" }. Pick any brand by name in the UI — the underlying value sent to ParuVendu is the cod. Leave empty for Any.