Leboncoin Real Estate Phone Leads Scraper

English | Français

---

English

Overview

Extract Leboncoin real estate ads with phone numbers using practical filters such as:

• city or all France
• price range
• property type
• furnished status
• rooms
• bedrooms
• surface
• energy rating
• elevator
• floor
• outdoor features
• orientation
• condition
• seller type
• keywords

This actor is built for real estate lead generation and returns structured results in the default dataset.

What this actor does

• Scrapes Leboncoin real estate ads
• Retrieves phone-number leads
• Supports city-specific search or France-wide search
• Lets you filter listings by key real-estate fields
• Writes clean structured results to the dataset
• Shows simple run logs with:
  • progress
  • current page
  • processed ads
  • found ads
  • phone leads
  • final results

Best for

• real estate lead generation
• rental lead collection
• apartment and house prospecting
• private seller research
• property ad monitoring
• market research

Input fields

Field	Type	Description
city	string	Optional city name. Leave empty to search across France
price_min	integer	Minimum property price
price_max	integer	Maximum property price
real_estate_type	array	Property type filter
furnished	array	Furnished status filter
rooms_min	integer	Minimum number of rooms
rooms_max	integer	Maximum number of rooms
bedrooms_min	integer	Minimum number of bedrooms
bedrooms_max	integer	Maximum number of bedrooms
surface_min	integer	Minimum surface in m²
surface_max	integer	Maximum surface in m²
energy_rate	array	Energy rating filter
elevator	boolean	Filter properties with elevator
floor_property	array	Floor filter
outside_access	array	Outdoor features filter
orientation	array	Property orientation filter
global_condition	array	Property condition filter
text	string	Optional real estate keywords
owner_type	string	all, private, or pro
only_with_phone	boolean	Keep only ads with a phone number
max_pages	integer	Optional page limit
max_items	integer	Number of results to collect. Default 1000, max 20000
request_id	string	Optional custom request identifier

Example input

{
  "city": "Paris",
  "price_min": 500,
  "price_max": 1500,
  "real_estate_type": ["2"],
  "furnished": ["1"],
  "rooms_min": 2,
  "rooms_max": 4,
  "bedrooms_min": 1,
  "surface_min": 25,
  "surface_max": 120,
  "owner_type": "private",
  "only_with_phone": true,
  "max_items": 1000
}

How only_with_phone works

If:

{
  "only_with_phone": true
}

the actor keeps only results that contain a phone number in the final dataset.

This means:

• ads without a phone number are skipped from final output
• cached phone numbers are reused when available
• live phone lookup is used when needed

Result limit note

• default max_items is 1000
• maximum max_items is 20000

Typical property values

Common examples used in filters:

• real_estate_type: ["1"], ["2"]
• furnished: ["1"], ["2"]
• energy_rate: ["a"], ["b"], ["c"], ["d"], ["e"], ["f"], ["g"]
• owner_type: all, private, pro

Output fields

Typical output fields include:

• list_id
• url
• subject
• price
• price_cents
• has_phone
• phonenumber
• owner.type
• owner.name
• location.city
• location.city_label
• location.zipcode
• location.department_id
• location.region_name
• real_estate_type
• square
• rooms
• bedrooms
• furnished
• energy_rate
• ges
• outside_access
• floor_property
• elevator
• orientation
• global_condition
• land_plot_surface
• first_publication_date
• index_date
• status
• images.nb_images
• body

Example output item

{
  "list_id": "3178003486",
  "url": "https://www.leboncoin.fr/ad/locations/3178003486",
  "subject": "Appartement meublé 2 pièces",
  "price": 950,
  "price_cents": 95000,
  "has_phone": true,
  "phonenumber": "0612345678",
  "owner.type": "private",
  "owner.name": "Jean",
  "location.city": "Paris",
  "location.city_label": "Paris 15e Arrondissement",
  "location.zipcode": "75015",
  "location.department_id": "75",
  "location.region_name": "Île-de-France",
  "real_estate_type": "Appartement",
  "square": 42,
  "rooms": 2,
  "bedrooms": 1,
  "furnished": "Meublé",
  "energy_rate": "D",
  "elevator": "Oui",
  "status": "active"
}

Pricing

This actor can be monetized on a simple result basis:

$1.00 / 1,000 results

Notes

• city is optional
• if city is empty, the actor searches across France
• output is handled in JSON and written to the default dataset
• max_workers is fixed internally

---

Français

Présentation

Extrayez des annonces immobilières Leboncoin avec numéros de téléphone grâce à des filtres pratiques comme :

• ville ou toute la France
• plage de prix
• type de bien
• statut meublé / non meublé
• nombre de pièces
• nombre de chambres
• surface
• étiquette énergétique
• ascenseur
• étage
• extérieurs
• orientation
• état du bien
• type de vendeur
• mots-clés

Cet actor est conçu pour la génération de leads immobiliers et retourne des résultats structurés dans le dataset par défaut.

Ce que fait cet actor

• Scrape les annonces immobilières Leboncoin
• Récupère des leads avec numéros de téléphone
• Permet une recherche par ville ou sur toute la France
• Utilise des filtres immobiliers utiles
• Écrit les résultats structurés dans le dataset
• Affiche des logs simples avec :
  • progression
  • page actuelle
  • annonces traitées
  • annonces trouvées
  • leads avec téléphone
  • résultats finaux

Cas d’usage

• génération de leads immobiliers
• prospection location
• recherche d’appartements et maisons
• recherche de vendeurs particuliers
• veille d’annonces
• étude de marché immobilier

Champs d’entrée

Champ	Type	Description
city	string	Ville optionnelle. Laissez vide pour chercher sur toute la France
price_min	integer	Prix minimum
price_max	integer	Prix maximum
real_estate_type	array	Filtre type de bien
furnished	array	Filtre meublé / non meublé
rooms_min	integer	Nombre minimum de pièces
rooms_max	integer	Nombre maximum de pièces
bedrooms_min	integer	Nombre minimum de chambres
bedrooms_max	integer	Nombre maximum de chambres
surface_min	integer	Surface minimum en m²
surface_max	integer	Surface maximum en m²
energy_rate	array	Filtre étiquette énergétique
elevator	boolean	Filtrer les biens avec ascenseur
floor_property	array	Filtre étage
outside_access	array	Filtre extérieurs
orientation	array	Filtre orientation
global_condition	array	Filtre état du bien
text	string	Mots-clés immobiliers optionnels
owner_type	string	all, private ou pro
only_with_phone	boolean	Garder uniquement les annonces avec téléphone
max_pages	integer	Limite optionnelle du nombre de pages
max_items	integer	Nombre de résultats à collecter. Par défaut 1000, maximum 20000
request_id	string	Identifiant facultatif

Exemple d’entrée

{
  "city": "Paris",
  "price_min": 500,
  "price_max": 1500,
  "real_estate_type": ["2"],
  "furnished": ["1"],
  "rooms_min": 2,
  "rooms_max": 4,
  "bedrooms_min": 1,
  "surface_min": 25,
  "surface_max": 120,
  "owner_type": "private",
  "only_with_phone": true,
  "max_items": 1000
}

Fonctionnement de only_with_phone

Si vous utilisez :

{
  "only_with_phone": true
}

l’actor gardera uniquement les résultats contenant un numéro de téléphone dans le dataset final.

Cela signifie :

• les annonces sans numéro sont exclues de la sortie finale
• les numéros déjà présents en cache sont réutilisés
• une recherche du numéro est lancée si nécessaire

Limite sur les résultats

• max_items par défaut est 1000
• max_items maximum est 20000

Valeurs de filtres courantes

Exemples fréquents :

• real_estate_type: ["1"], ["2"]
• furnished: ["1"], ["2"]
• energy_rate: ["a"], ["b"], ["c"], ["d"], ["e"], ["f"], ["g"]
• owner_type: all, private, pro

Champs de sortie

Les champs de sortie typiques incluent :

• list_id
• url
• subject
• price
• price_cents
• has_phone
• phonenumber
• owner.type
• owner.name
• location.city
• location.city_label
• location.zipcode
• location.department_id
• location.region_name
• real_estate_type
• square
• rooms
• bedrooms
• furnished
• energy_rate
• ges
• outside_access
• floor_property
• elevator
• orientation
• global_condition
• land_plot_surface
• first_publication_date
• index_date
• status
• images.nb_images
• body

Exemple de résultat

{
  "list_id": "3178003486",
  "url": "https://www.leboncoin.fr/ad/locations/3178003486",
  "subject": "Appartement meublé 2 pièces",
  "price": 950,
  "price_cents": 95000,
  "has_phone": true,
  "phonenumber": "0612345678",
  "owner.type": "private",
  "owner.name": "Jean",
  "location.city": "Paris",
  "location.city_label": "Paris 15e Arrondissement",
  "location.zipcode": "75015",
  "location.department_id": "75",
  "location.region_name": "Île-de-France",
  "real_estate_type": "Appartement",
  "square": 42,
  "rooms": 2,
  "bedrooms": 1,
  "furnished": "Meublé",
  "energy_rate": "D",
  "elevator": "Oui",
  "status": "active"
}

Tarification

Cet actor peut être monétisé simplement au résultat :

$1.00 / 1 000 résultats

Remarques

• city est optionnel
• si city est vide, la recherche se fait sur toute la France
• la sortie est gérée en JSON puis écrite dans le dataset par défaut
• max_workers est fixé en interne