Leboncoin Auto & Moto Scraper Pro

Scrape leboncoin.fr car and motorcycle listings with full search filters. Returns 50+ fields per ad including price estimate, mileage, registration year, fuel/gearbox, GPS coordinates, images and seller info.

Proxies are already included — nothing to configure, works out of the box.

---

Input

Proxies are already provided — no proxy setup needed.

Parameter	Type	Required	Default	Description
vehicleType	string	—	voiture	voiture (cars) or moto (motorcycles)
keywords	string	—	—	Free-text search: clio, golf 7 diesel, mt07, etc.
brand	string	—	—	Exact brand filter: Renault, Peugeot, BMW, Yamaha, Harley-Davidson (case-insensitive)
city	string	—	France	City or postcode: Paris, 75015, Lyon 3, Bordeaux
radius	integer	—	10000	Search radius in metres around the city (500–100000)
priceMin	integer	—	—	Minimum price (€)
priceMax	integer	—	—	Maximum price (€)
yearMin	integer	—	—	Minimum registration year
yearMax	integer	—	—	Maximum registration year
mileageMin	integer	—	—	Minimum mileage (km)
mileageMax	integer	—	—	Maximum mileage (km)
fuel	array	—	—	One or more of: essence, diesel, gpl, electrique, hybride, hybride_rechargeable, gaz_naturel, hydrogene, autre
gearbox	string	—	—	manuelle or automatique
engineSizeMax	integer	—	—	Max engine displacement in cm³ — motos only
maxAds	integer	—	100	Maximum ads to collect (1–5000)
delay	float	—	2.0	Seconds between page requests (0.5–30)
forceDescription	boolean	—	true	Visit each ad's page to fill in description (see note under Output below and Pricing below). Enabled by default — disable to skip this step, speed up runs, and avoid the extra charge.

Example Input — Cars

{
  "vehicleType": "voiture",
  "keywords": "clio",
  "brand": "Renault",
  "city": "Lyon",
  "priceMax": 15000,
  "fuel": ["essence", "diesel"],
  "maxAds": 50
}

Example Input — Motorcycles

{
  "vehicleType": "moto",
  "brand": "Yamaha",
  "city": "Marseille",
  "priceMax": 8000,
  "engineSizeMax": 700,
  "maxAds": 50
}

---

Pricing

Each ad returned is charged as 1 result. forceDescription is enabled by default and fills in the description field (see below) — every ad for which a description is actually found is charged as 1 extra result on top of its normal charge, at the same per-result price you already pay. No separate fixed fee, and ads where no description could be fetched aren't charged extra. Disable forceDescription in the Input if you don't need the full description text and want to avoid the extra charge.

---

Output

Each item in the dataset represents one ad. Fields that don't apply to the vehicle type (e.g. doors for a moto, motorcycle_type for a car) are returned empty/zero rather than omitted, so every item has the same shape.

Field	Type	Description
id	integer	Leboncoin listing ID
url	string	Direct URL to the ad
title	string	Ad title
description	string	Full ad description — empty "" if forceDescription is disabled or no description could be fetched for that ad
status	string	Ad status (active, etc.)
ad_type	string	offer or demand
category	string	Voitures or Motos
published_at	string	First publication date
updated_at	string	Last update date
price_eur	integer	Asking price in euros
estimated_price_min	integer	Leboncoin's estimated fair-price range, low bound
estimated_price_max	integer	Leboncoin's estimated fair-price range, high bound
price_rating	string	Price positioning label, e.g. Prix équitable, Au-dessus du marché
monthly_payment_eur	integer	Monthly financing payment estimate
financing_partner	string	Financing partner name, if any
brand	string	Vehicle brand
model	string	Vehicle model
finition	string	Trim level
version	string	Full commercial version name
registration_year	integer	First registration year
registration_date	string	First registration month/year, e.g. 07/2022
mileage_km	integer	Mileage in kilometers
fuel_type	string	Essence, Diesel, Électrique, Hybride, etc.
gearbox_type	string	Manuelle or Automatique
color	string	Vehicle color
condition	string	Overall condition, e.g. Bon état général
is_import	boolean	Vehicle was imported
engine_power_hp	integer	Engine power in DIN horsepower
engine_power_fiscal_cv	integer	Fiscal horsepower (puissance fiscale)
engine_size_cm3	integer	Engine displacement in cm³ — motos only
doors	string	Number of doors — cars only ("6 ou plus" for 6+)
seats	string	Number of seats — cars only ("7 ou plus" for 7+)
body_type	string	Body style — cars only, e.g. Berline, Break, 4x4
critair	string	Crit'Air vignette class (0–5) — cars only
vehicle_history_url	string	Public Histovec/Autoviza history report URL, if published
vehicle_history_status	string	History report visibility status
motorcycle_type	string	Motorcycle style — motos only, e.g. Trail, Roadster
license_required	string	Required driving license — motos only, e.g. A, Sans permis
euro_emissions_standard	string	Euro emissions standard — motos only
next_technical_inspection	string	Next roadworthy inspection year — motos only
equipment	string	Comma-separated list of equipment/options
spare_parts_availability	string	Spare parts availability rating
custom_ref	string	Seller's internal reference code
location_city	string	City name
location_zipcode	string	Postal code
location_department	string	Department name
location_dept_id	string	Department number
location_region	string	Region name
location_lat	number	GPS latitude
location_lng	number	GPS longitude
seller_name	string	Seller display name
seller_type	string	private or pro
seller_store_name	string	Dealer/store name, if pro
seller_siren	string	Seller SIREN number, if pro
seller_user_id	string	Leboncoin internal seller user ID
seller_has_phone	boolean	Phone number available
images_count	integer	Number of photos
images_thumbnail	string	Thumbnail image URL
images_urls	array	All photo URLs
is_boosted	boolean	Ad is boosted/promoted
is_urgent	boolean	Ad marked as urgent
is_highlighted	boolean	Ad is highlighted
rank	integer	Position in results (1 = first)

Example Output Item (car)

{
  "id": 3179721158,
  "url": "https://www.leboncoin.fr/ad/voitures/3179721158",
  "title": "Renault Clio 1.0 SCe 65ch Zen",
  "price_eur": 11499,
  "estimated_price_min": 11070,
  "estimated_price_max": 12230,
  "price_rating": "Prix équitable",
  "brand": "Renault",
  "model": "Clio",
  "registration_year": 2022,
  "mileage_km": 50732,
  "fuel_type": "Essence",
  "gearbox_type": "Manuelle",
  "color": "Blanc",
  "engine_power_hp": 67,
  "doors": "5",
  "seats": "5",
  "body_type": "Citadine",
  "critair": "1",
  "location_city": "Lyon",
  "location_zipcode": "69001",
  "location_region": "Rhône-Alpes",
  "seller_type": "pro",
  "seller_has_phone": true,
  "images_count": 30,
  "rank": 1
}

---

Proxy

Proxies are already included — nothing to configure.

---

Technical Notes

• Pagination: follows leboncoin's ?page=N parameter, up to max_pages returned by the API
• Data source: extracts __NEXT_DATA__ JSON embedded in page HTML — no extra requests per ad by default for search fields
• description field: leboncoin's search-results API always returns an empty body for every ad — the full text only exists on the ad's own detail page, and leboncoin has no bulk/batch endpoint for it, so there's no way around one extra request per ad. forceDescription (enabled by default) has the actor visit each ad's page (up to 25 pages fetched concurrently) and fill in description — see Pricing above for billing. Disable it to skip this extra step and speed up runs.
• Rate limiting: configurable delay between search-result pages (default 2s). Detail-page fetches (forceDescription) run concurrently instead (25 at a time) rather than using delay.
• Deduplication: ads are deduplicated by list_id across pages
• City resolver: uses api-adresse.data.gouv.fr to convert city names/postcodes to leboncoin location format
• Range filters (price, year, mileage) always send an explicit lower/upper bound — leboncoin's search silently returns 0 results for open-ended ranges (e.g. 2015-) when combined with a city filter

---

Supported Cities

Any French city or postcode. Examples:

• Paris, Paris 15, 75015
• Lyon, Lyon 3, 69003
• Marseille, 13008
• Bordeaux, 33000
• Toulouse, Nantes, Nice, Strasbourg, Montpellier…

Fuel & Gearbox Codes

For reference — the values used by the fuel and gearbox input filters:

fuel value	Label (FR)
essence	Essence
diesel	Diesel
gpl	GPL
electrique	Électrique
hybride	Hybride
hybride_rechargeable	Hybride Rechargeable
gaz_naturel	Gaz Naturel (GNV)
hydrogene	Hydrogène
autre	Autre

gearbox value	Label (FR)
manuelle	Manuelle
automatique	Automatique

---

Hashtags & Keywords (SEO / AI referencing)

leboncoin scraper, leboncoin.fr scraper, leboncoin voitures scraper, leboncoin motos scraper, scrape leboncoin, leboncoin API, leboncoin car listings, leboncoin used cars, French classifieds scraper, voitures d'occasion scraper, annonces auto scraper, annonces moto scraper, car marketplace scraper France, French car marketplace, scrape voitures occasion, extraction annonces leboncoin, leboncoin data extraction, leboncoin dataset, leboncoin bulk export, leboncoin JSON CSV, leboncoin price estimation, leboncoin GPS location, leboncoin seller info, leboncoin images scraper, Apify leboncoin actor, Apify France automotive scraper, used car data France, moto occasion scraper, French vehicle listings, car dealer data scraper, automotive lead generation France, scraping annonces véhicules, #leboncoin #leboncoinscraper #voituresoccasion #motosoccasion #webscraping #apify #dataextraction #automotivedata #franceclassifieds #carmarketplace #leadgeneration #aiSEO #seo