🏠 Leboncoin Universal Scraper - Real Estate

English | Français

Scrape Leboncoin real estate with simple filters — no URL needed. Pick a transaction (rent, sale, flatshare…), a location and your criteria, and export structured data as JSON, CSV or Excel.

📋 Contents

• Overview
• How to use
• Input
• Filters reference
• Output
• Proxy and performance
• Related Actors
• FAQ
• Support

📖 Overview

Choose what to search (for rent, for sale, flatshares, holiday rentals, new builds, offices) and your filters. The Actor turns it into the exact Leboncoin search and collects every matching listing: title, price/rent, description, typed attributes (surface, rooms, bedrooms, DPE, GES, heating, floor…), images, seller signals and full geolocation.

• No URL to build — pick a transaction and your criteria.
• Full real-estate filter set — property type, surface, rooms, bedrooms, bathrooms, land, DPE/GES, heating, elevator, orientation, floor, parking, construction year, sale type, condition — plus an advanced object for anything else (see the Filters reference).
• Locations by name — city, arrondissement or postal code (geocoded automatically); empty = all France.
• Complete coverage — automatic price-splitting for large result sets.
• Exports to JSON, CSV, Excel, or the Apify dataset API.

Looking for cars or motorbikes? Use the Leboncoin Universal Scraper - Vehicles. Prefer pasting a search URL for any category? Use the Leboncoin Scraper (URL mode).

🚀 How to use

1. Pick a transaction (for rent / for sale / flatshares / holiday / new build / offices).
2. Add a location (city / postcode) — or leave empty for all France.
3. Set your filters: price, property type, surface, rooms, DPE, seller type… anything not listed goes in Advanced filters (see the Filters reference).
4. Start the run and download your data from the Storage tab or the API.

📥 Input

Field	Key	Type	Description
Transaction	category	string	10 rent, 9 sale, 11 flatshares, 12 holiday, 304 new build, 13 offices (dropdown).
Locations	locations	array	Cities / arrondissements / postal codes, e.g. Lyon, 75011. Empty = all France.
Keywords	text	string	Free-text keywords.
Min / Max price	price_min / price_max	integer	Price / rent range in €.
Seller type	owner_type	string	all, private or pro.
Sort	sort	string	relevance, newest, price_asc, price_desc.
Property type	property_types	array	apartment, house, land, parking, other.
Surface / land	surface_min/max, land_surface_min/max	integer	m².
Rooms / bedrooms / bathrooms	rooms_min, bedrooms_min, bathrooms_min	integer	Minimums.
Energy	energy_rate, ges	array	DPE / GES classes a–g.
Comfort	furnished, heating_type, heating_mode, elevator, orientation, floor_min, parkings_min	—	See the Filters reference.
Build / sale	building_year_min/max, immo_sell_type, property_condition	—	Construction year, sale type, condition.
Advanced filters	filters	object	Any other Leboncoin filter — key: [codes] (enum) or key: {"min":.., "max":..} (range). See the Filters reference.
Max results	max_results	integer	How many listings to collect (0 = all).
Proxy	proxyConfiguration	object	Residential FR recommended.

🎛️ Filters reference

Every dedicated input maps to one Leboncoin filter — the table below gives the underlying key and its codes. The Advanced filters (filters) object accepts any other Leboncoin filter: each entry is either an enum (a list of codes) or a range ({"min": …, "max": …}). Codes verified live against the Leboncoin API (July 2026).

Dedicated input	Leboncoin key	Type	Values / codes
property_types	real_estate_type	enum	apartment→2 · house→1 · land→3 · parking→4 · other→5
surface_min/max	square	range	Living surface (m²)
rooms_min	rooms	range	Number of rooms (pièces)
bedrooms_min	bedrooms	range	Number of bedrooms
bathrooms_min	nb_bathrooms	range	Number of bathrooms
land_surface_min/max	land_plot_surface	range	Land / plot surface (m²)
furnished	furnished	enum	1 Furnished · 2 Unfurnished
energy_rate	energy_rate	enum	DPE classes a–g
ges	ges	enum	GES classes a–g
heating_type	heating_type	enum	individual, communal
heating_mode	heating_mode	enum	gas, electric, fuel, other
elevator	elevator	enum	1 With · 2 Without
orientation	orientation	enum	north, south, east, west, north_east, north_west, south_east, south_west
floor_min	floor_number	range	Floor number
parkings_min	nb_parkings	range	Number of parking spaces
building_year_min/max	building_year	range	Construction year
immo_sell_type	immo_sell_type	enum	old Existing · new New build · viager Life annuity
property_condition	global_condition	enum	1 Excellent · 2 Good · 3 Renovated · 4 To refresh

Using Advanced filters — pass the Leboncoin key directly (it also lets you override any dedicated input, e.g. use a range for rooms instead of a minimum):

"filters": {
  "energy_rate": ["a", "b", "c"],
  "rooms": { "min": 2, "max": 4 },
  "land_plot_surface": { "min": 300 },
  "elevator": ["1"]
}

💡 Finding any key or code: build your search on leboncoin.fr and read the URL — the query parameters are exactly these keys and values (e.g. real_estate_type=2&square=30-80&energy_rate=a,b). Anything in the URL works in Advanced filters.

📤 Output

Each listing is one dataset item (JSON / CSV / Excel / API). Fields include id, subject, body, price, url, category_name, typed attributes[] (surface, rooms, bedrooms, DPE, GES, heating…), images[], location{} (city, zipcode, lat, lng), has_phone, scraped_at, and search_category / search_location.

🛡️ Proxy and performance

• Use Apify residential proxies (country FR) for the most reliable runs.
• Set Max results to the volume you want; use 0 to collect everything available.
• Add a price range for very large searches — the Actor splits it automatically to cover all results.

🔗 Related Actors

• Leboncoin Universal Scraper - Vehicles — cars, motorbikes, vans… by filters.
• Leboncoin Scraper — any category, by URL.
• SeLoger Universal Scraper — real estate on SeLoger.

❓ FAQ

Which transactions are supported? For rent, for sale, flatshares, holiday rentals, new builds, and offices & commercial.

How do I find a filter's code? Build the search on leboncoin.fr and read the URL parameters (e.g. real_estate_type=2&square=30-80), or see the Filters reference.

Is this legal? The Actor collects publicly available data. Comply with Leboncoin's Terms of Service, GDPR and applicable laws.

How fresh is the data? Collected live at runtime.

💬 Support

Questions or issues? Post them in the Issues tab.

---

🏠 Leboncoin Universal Scraper - Real Estate (Français)

English | Français

Scrapez l'immobilier Leboncoin avec des filtres simples — sans URL. Choisissez une transaction (location, vente, colocation…), un lieu et vos critères, et exportez des données structurées en JSON, CSV ou Excel.

📋 Sommaire

• Présentation
• Utilisation
• Paramètres
• Référence des filtres
• Données extraites
• Proxy et performance
• Actors similaires
• FAQ
• Support

📖 Présentation

Choisissez quoi chercher (location, vente, colocation, saisonnier, neuf, bureaux) et vos filtres. L'Actor construit la recherche Leboncoin exacte et collecte toutes les annonces : titre, prix/loyer, description, attributs typés (surface, pièces, chambres, DPE, GES, chauffage, étage…), images, signaux vendeur et géolocalisation complète.

• Aucune URL à construire — juste une transaction et vos critères.
• Tous les filtres immobiliers — type de bien, surface, pièces, chambres, salles de bain, terrain, DPE/GES, chauffage, ascenseur, orientation, étage, parking, année de construction, type de vente, état — plus un objet avancé pour le reste (voir la référence des filtres).
• Lieux par nom — ville, arrondissement ou code postal (géocodés) ; vide = toute la France.
• Couverture complète — découpe automatique par prix pour les gros volumes.
• Export JSON, CSV, Excel, ou API dataset Apify.

Vous cherchez des voitures ou des motos ? Utilisez le Leboncoin Universal Scraper - Vehicles. Vous préférez coller une URL (toute catégorie) ? Utilisez le Leboncoin Scraper (mode URL).

🚀 Utilisation

1. Choisissez une transaction (location / vente / colocation / saisonnier / neuf / bureaux).
2. Ajoutez un lieu (ville / code postal) — ou laissez vide pour toute la France.
3. Réglez vos filtres : prix, type de bien, surface, pièces, DPE, type de vendeur… le reste va dans Advanced filters (voir la référence des filtres).
4. Lancez le run et récupérez vos données dans l'onglet Storage ou l'API.

📥 Paramètres

Champ	Clé	Type	Description
Transaction	category	chaîne	10 location, 9 vente, 11 colocation, 12 saisonnier, 304 neuf, 13 bureaux (menu déroulant).
Localisations	locations	tableau	Villes / arrondissements / codes postaux, ex. Lyon, 75011. Vide = toute la France.
Mots-clés	text	chaîne	Recherche par mots-clés.
Prix min / max	price_min / price_max	entier	Fourchette de prix / loyer en €.
Type de vendeur	owner_type	chaîne	all, private ou pro.
Tri	sort	chaîne	relevance, newest, price_asc, price_desc.
Type de bien	property_types	tableau	apartment, house, land, parking, other.
Surface / terrain	surface_min/max, land_surface_min/max	entier	m².
Pièces / chambres / SdB	rooms_min, bedrooms_min, bathrooms_min	entier	Minimums.
Énergie	energy_rate, ges	tableau	Classes DPE / GES a–g.
Confort	furnished, heating_type, heating_mode, elevator, orientation, floor_min, parkings_min	—	Voir la référence des filtres.
Construction / vente	building_year_min/max, immo_sell_type, property_condition	—	Année, type de vente, état.
Advanced filters	filters	objet	Tout autre filtre Leboncoin — clé : [codes] (enum) ou clé : {"min":.., "max":..} (plage). Voir la référence des filtres (tableau clés/codes, en anglais).
Résultats max	max_results	entier	Nombre d'annonces à collecter (0 = tout).
Proxy	proxyConfiguration	objet	Résidentiel FR recommandé.

📤 Données extraites

Chaque annonce est un élément du dataset (JSON / CSV / Excel / API). Champs : id, subject, body, price, url, category_name, attributes[] typés (surface, pièces, chambres, DPE, GES, chauffage…), images[], location{} (ville, code postal, lat, lng), has_phone, scraped_at, et search_category / search_location.

🛡️ Proxy et performance

• Utilisez les proxies résidentiels Apify (pays FR) pour des runs plus fiables.
• Réglez Résultats max selon le volume voulu ; mettez 0 pour tout récupérer.
• Ajoutez une fourchette de prix pour les très grosses recherches — l'Actor la découpe automatiquement pour tout couvrir.

🔗 Actors similaires

• Leboncoin Universal Scraper - Vehicles — voitures, motos, utilitaires… par filtres.
• Leboncoin Scraper — toute catégorie, par URL.
• SeLoger Universal Scraper — immobilier sur SeLoger.

❓ FAQ

Quelles transactions ? Location, vente, colocation, saisonnier, neuf, et bureaux & commerces.

Comment trouver le code d'un filtre ? Construisez la recherche sur leboncoin.fr et lisez les paramètres de l'URL (ex. real_estate_type=2&square=30-80), ou voir la référence des filtres.

Est-ce légal ? L'Actor collecte des données publiquement accessibles. Respectez les CGU de Leboncoin, le RGPD et les lois applicables.

Les données sont-elles à jour ? Collectées en direct au moment du run.

💬 Support

Une question ou un souci ? Postez dans l'onglet Issues.