Leboncoin Scraper

Extract structured classified listings from leboncoin.fr, the French classifieds marketplace, at scale. The actor calls the same JSON API the leboncoin mobile app uses, so there is no browser automation and no HTML parsing. It works across all categories (real estate, cars, jobs and more) with filters for location, price, surface, rooms and seller type, and returns the full ad data.

Who it's for

• Real-estate investors & analysts — monitor prices and inventory, build yield and market-trend datasets.
• Agencies & lead-gen teams — pull seller lists (private vs professional) with location and category coverage.
• PropTech / SaaS developers — a dependable listings feed to power apps, dashboards, and alerts.
• Researchers & data teams — GPS-mapped, structured market data.

Output fields

Field	Type	Description
list_id	integer	Unique listing id
url	string	Listing URL
subject / body	string	Title and description
category_id / category_name	string	Leboncoin category
price / price_cents	integer	Price in euros / cents
owner_name / owner_type	string	Seller name and type (private/pro)
owner_store_id / owner_siren	string	Professional seller identifiers
city / zipcode / district	string	Localisation
department_id / region_id	string	Administrative area ids
lat / lng	number	GPS coordinates
real_estate_type	string	House, apartment, land…
square / rooms / bedrooms	string	Surface (m²) and rooms
energy_rate / ges	string	DPE / GES energy ratings
nb_images / images / thumbnail	array	Photo URLs
has_phone	boolean	Whether the seller exposes a phone
attributes / attribute_labels	object	Every raw attribute (key→value / key→label)

High-value use cases

• Investment screening — pull all apartments for sale in a department under a price ceiling, with m², rooms and DPE, straight into a spreadsheet.
• Lead generation — collect professional sellers in a region for outreach.
• Price intelligence — schedule daily runs to track price changes and new inventory in a market.
• Geo analysis — map inventory with per-ad GPS coordinates.
• Vehicle market data — switch category to cars (2) or motorbikes; the vehicle specs (brand, model, mileage, fuel, gearbox, year) come in the attributes object.

Input parameters

Field	Type	Default	Description
category	string	9	Category id (9 sales, 10 rentals, 2 cars…)
keywords	string	—	Free-text query
departmentIds	array	—	e.g. ["75","92"]
regionIds	array	—	e.g. ["12"]
geo	object	—	{ "lat":48.85, "lng":2.35, "radiusKm":10 }
realEstateTypes	array	—	house / apartment / land / parking / other
priceMin / priceMax	integer	—	Price range (€)
squareMin / squareMax	integer	—	Surface range (m²)
roomsMin / roomsMax	integer	—	Rooms range
ownerType	string	all	all / private / pro
sortBy / sortOrder	string	time / desc	Sorting
fetchDetails	boolean	false	Enrich each ad with its full detail payload
maxItems	integer	100	Result cap
proxyConfiguration	object	Apify RESIDENTIAL, FR	Proxy used for the requests

Example input

{
    "category": "9",
    "departmentIds": ["75"],
    "priceMax": 600000,
    "roomsMin": 2,
    "sortBy": "time",
    "maxItems": 100
}

Example output (one row)

{
    "list_id": 3215089029,
    "url": "https://www.leboncoin.fr/ad/ventes_immobilieres/3215089029",
    "subject": "Appartement 5 pièces 140 m²",
    "price": 1855000,
    "city": "Paris",
    "zipcode": "75116",
    "department_name": "Paris",
    "lat": 48.87617,
    "lng": 2.271965,
    "real_estate_type": "Appartement",
    "square": "140",
    "rooms": "5",
    "owner_type": "pro",
    "nb_images": 10,
    "has_phone": true
}

Scheduling & integrations

Schedule runs (hourly/daily) from the Apify Console, or trigger via API/webhook. Export to Google Sheets, Make, Zapier, Amazon S3, or pull results through the Apify API/SDK. Every field lands as clean JSON.

AI assistants (MCP)

Prefer to query leboncoin from Claude, Cursor, or a custom agent? Use the companion Leboncoin MCP actor, which exposes live search / detail / seller tools over the Model Context Protocol.

FAQ

How many results can I get? As many as the search returns; the actor follows leboncoin's cursor until the result set ends or maxItems is reached. Use narrower filters (department, price band) to slice very large markets.

How fresh is the data? Live. Every run queries leboncoin in real time.

Do I need proxies? Leboncoin sits behind DataDome, and the actor is tuned for the default setting: Apify RESIDENTIAL proxies with country France. Requests from datacenter or non-French exits are challenged much more often. When a request is challenged, the actor automatically switches to a new exit IP and a new session and carries on, so a run may log one or two rotations. If it still cannot get through after several rotations it stops and reports the problem instead of returning empty data.

Why are some fields empty? Fields that do not apply to a category are null (for example rooms on a car ad, or furnished on a sale). Vehicle and other category-specific attributes are always available in attributes / attribute_labels.

Do sponsored ads appear? No. Sponsored ads leboncoin injects into result lists are switched off, so sorting by price or date is clean.

Can I get seller phone numbers? The dataset includes a has_phone flag; actual phone numbers require an authenticated leboncoin account and are out of scope.

Is scraping legal? You are responsible for complying with leboncoin's terms and applicable law. Scrape only public data and respect rate limits and privacy rules.