Leboncoin Immobilier | Annonces Immobilieres avec Numeros de Telephone

Par Clearpath, créateurs du scraper Leboncoin n°1 sur Apify, avec une suite dédiée aux annonces, aux numéros de téléphone et à la messagerie acheteur.

Pourquoi choisir cet actor ?

Les contacts pour passer à l’action. Récupérez les numéros disponibles des particuliers et des agences avec les annonces. Ajoutez les profils vendeurs : avis, réactivité et informations professionnelles lorsqu’elles sont publiées.

Les données pour comparer les biens. Exportez la surface habitable, le terrain, les pièces, les chambres, le DPE et le GES, ainsi que les équipements indiqués dans l’annonce. Photos, localisation et description restent dans le même résultat.

Vos critères, vos nouvelles annonces. Collez une URL de recherche Leboncoin ou filtrez par type de bien, surface, DPE et localisation. Le mode surveillance collecte les nouvelles annonces correspondantes et peut les transmettre à Telegram ou à votre webhook.

Essayez sur votre secteur

Cet exemple recherche 10 annonces de maisons à Bordeaux, avec les options téléphone et profil vendeur activées. Renseignez aussi votre e-mail et votre mot de passe Leboncoin dans le formulaire pour récupérer les numéros. Le mot de passe se saisit dans un champ secret.

{
  "searchQuery": "maison",
  "location": "Bordeaux",
  "immobilierCategory": "9",
  "adLimit": 10,
  "includePhone": true,
  "includeSeller": true
}

Ouvrir les paramètres pour ajouter vos identifiants et adapter la recherche. Si Leboncoin demande un code SMS ou e-mail, relancez avec le champ twoFactorCode.

Les profils vendeurs et les numéros de téléphone sont des options facturées séparément selon la tarification. Un numéro introuvable n’est pas facturé. Les champs disponibles dépendent de chaque annonce.

Clearpath · Leboncoin Suite
Immobilier Vous êtes ici	Annonces Recherche & détails	Téléphones Contacts vendeurs	Annonces PPE À l’usage	Acheteur Messages & inbox

Copy to your AI assistant

Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor.

clearpath/leboncoin-immobilier on Apify. Call: ApifyClient("TOKEN").actor("clearpath/leboncoin-immobilier").call(run_input={...}), then client.dataset(run["defaultDatasetId"]).list_items().items for results. Key inputs: searchUrl (string), searchQuery (string), adLimit (integer), includePhone (boolean), email/password for phone lookup, twoFactorCode (optional string, secret; use on second run if leboncoin sends an SMS or email verification code). Full actor spec (input schema with all params/enums/defaults, output dataset fields, README): GET https://api.apify.com/v2/acts/clearpath~leboncoin-immobilier/builds/default (Bearer TOKEN) → inputSchema, actorDefinition.storages.dataset, readme. Pricing: pay-per-event. $1.49 per 1,000 ads scraped (tiered down to $0.99 on higher Apify plans), $4.99 per 1,000 ads fetched from a direct ad URL, $2.99 per 1,000 seller profiles, $9.99 per 1,000 phone numbers. No subscription. Get token: https://console.apify.com/account/integrations

Fonctionnalites

• 15+ filtres immobiliers -- Type de bien, pieces, chambres, surface, terrain, DPE, GES, etage, ascenseur, balcon, terrasse, jardin, piscine
• Filtres locations saisonnieres -- Dates d'arrivee/depart, capacite (personnes), type d'hebergement (gite, B&B, camping), paiement en ligne
• Numeros de telephone -- Recuperez les coordonnees des vendeurs et agences (option facturée par numéro trouvé)
• 6 categories -- Ventes, Locations, Locations saisonnieres, Colocations, Bureaux & Commerces, Immobilier Neuf
• Mode surveillance -- Detecte les nouvelles annonces et envoie des alertes Telegram ou un POST JSON vers votre webhook (Make, Zapier, n8n)
• Recherche par URL -- Collez une URL leboncoin.fr, tous les filtres sont extraits automatiquement
• Profils vendeurs -- Nom, type, SIREN, note, taux de reponse, badges

Tarifs

Ce qui est facture	Prix
Demarrage du run	0,009 $ par execution
Annonce extraite	1,49 $ / 1 000 (1,29 $ Silver, 0,99 $ Gold et plus)
Annonce via URL directe	4,99 $ / 1 000
Profil vendeur	2,99 $ / 1 000 profils
Numero de telephone	9,99 $ / 1 000 numeros

Vous ne payez que ce que vous extrayez. Aucun abonnement. Un profil vendeur est facture une seule fois par vendeur, meme s'il publie plusieurs annonces, et un numero introuvable n'est pas facture.

Numeros de telephone

Ce qui differencie cet acteur : il recupere les numeros de telephone des vendeurs et agences directement depuis leboncoin.fr. Facture 9,99 $ / 1 000 numeros, et seuls les numeros effectivement trouves sont factures.

• Fonctionne avec les annonces de particuliers et professionnels
• Necessite un compte leboncoin.fr gratuit (email + mot de passe)
• Les identifiants sont chiffres et jamais stockes en clair
• Si leboncoin demande un code SMS/email, les annonces sont retournees et les telephones sont ignores. Relancez avec twoFactorCode pour recuperer les numeros.

Activez includePhone: true avec vos identifiants : les numéros sont récupérés aussi bien sur une recherche que sur des URLs d'annonces précises.

Categories immobilieres

ID	Categorie	Exemple
9	Ventes immobilieres	Maisons, appartements, terrains a vendre
10	Locations	Appartements, maisons en location
12	Locations saisonnieres	Gites, locations de vacances, chambres d'hotes
11	Colocations	Chambres et colocations
13	Bureaux & Commerces	Locaux commerciaux, bureaux
2001	Immobilier Neuf	Programmes neufs

Demarrage rapide

Maisons a vendre a Paris, 3+ pieces, 150K-700K

{
  "immobilierCategory": "9",
  "location": "Paris",
  "real_estate_type": ["1"],
  "rooms_min": 3,
  "price_min_filter": 150000,
  "price_max_filter": 700000,
  "adLimit": 100
}

Appartements en location a Lyon, meuble, DPE A-C

{
  "immobilierCategory": "10",
  "location": "Lyon 69",
  "real_estate_type": ["2"],
  "furnished": "1",
  "energy_rate": ["a", "b", "c"],
  "adLimit": 200
}

Location saisonniere a Nice, 4 personnes minimum, gite ou B&B, du 15 au 22 juillet

{
  "immobilierCategory": "12",
  "location": "Nice",
  "radius": 10,
  "arrival_date": "2026-07-15",
  "departure_date": "2026-07-22",
  "capacity_min": 4,
  "accommodation_type": ["rental_or_gite", "bed_and_breakfast"],
  "bookable": true,
  "adLimit": 100
}

Via URL de recherche

{
  "searchUrl": "https://www.leboncoin.fr/recherche?category=9&locations=Bordeaux__44.84088_-0.58064_5571&real_estate_type=1,2&price=200000-500000&rooms=3-6&square=80-max",
  "adLimit": 500
}

Avec numeros de telephone

{
  "adDetailUrls": [
    "https://www.leboncoin.fr/ad/ventes_immobilieres/2891456723",
    "https://www.leboncoin.fr/ad/ventes_immobilieres/2891456724"
  ],
  "includePhone": true,
  "email": "votre@email.fr",
  "password": "votre_mot_de_passe"
}

Parametres d'entree

Recherche

Parametre	Type	Description
searchUrl	String	URL de recherche leboncoin.fr. Tous les filtres sont extraits automatiquement.
searchQuery	String	Recherche par mot-cle (ex: "maison piscine").
immobilierCategory	String	Categorie : 9 (Ventes), 10 (Locations), 12 (Locations saisonnieres), 11 (Colocations), 13 (Bureaux), 2001 (Neuf).
location	String	Ville ou departement (ex: "Paris", "Lyon 69"). Vide = toute la France.
adLimit	Integer	Nombre maximum d'annonces. Defaut : 100.

Filtres immobiliers

Parametre	Type	Description
real_estate_type	Array	Type de bien : 1 (Maison), 2 (Appartement), 3 (Terrain), 4 (Parking), 5 (Autre).
rooms_min / rooms_max	Integer	Nombre de pieces (1-8).
bedrooms_min / bedrooms_max	Integer	Nombre de chambres (1-8).
square_min / square_max	Integer	Surface habitable en m2.
land_square_min / land_square_max	Integer	Surface du terrain en m2.
energy_rate	Array	Classe DPE : a, b, c, d, e, f, g, v (vierge), n (non soumis).
furnished	String	Ameublement : 1 (Meuble), 2 (Non meuble). Locations uniquement.
floor_property	Array	Etage : ground_floor, upper_floor, last_stage.
elevator	Boolean	Uniquement les biens avec ascenseur.
outdoor	Array	Exterieur : balcony, terrace, garden, swimming_pool.
price_min_filter / price_max_filter	Integer	Fourchette de prix en euros.

Filtres locations saisonnieres (categorie 12)

Les filtres immobiliers classiques (rooms_min, square_min, furnished) ne s'appliquent pas aux Locations saisonnieres. Utilisez ceux-ci a la place :

Parametre	Type	Description
arrival_date	String	Date d'arrivee (format AAAA-MM-JJ, ex: 2026-07-15). Filtre par disponibilite.
departure_date	String	Date de depart (format AAAA-MM-JJ). A utiliser avec la date d'arrivee.
accommodation_type	Array	Type d'hebergement : rental_or_gite, bed_and_breakfast, campsite, unusual_accommodation.
capacity_min / capacity_max	Integer	Nombre de personnes pouvant etre logees (1-12).
bedrooms_min / bedrooms_max	Integer	Nombre de chambres (1-8).
bookable	Boolean	N'inclure que les annonces reservables en ligne.

Telephone

Parametre	Type	Description
includePhone	Boolean	Activer l'extraction des numeros de telephone.
email	String	Email de votre compte leboncoin.fr.
password	String	Mot de passe (champ Secret input, masque et chiffre).
twoFactorCode	String	Code de verification SMS/email. A utiliser au deuxieme lancement si leboncoin demande un code.

Options

Parametre	Type	Description	Defaut
mode	String	standard extrait les résultats actuels. monitor crée d'abord une référence bornée facturée et silencieuse, puis livre les nouveautés au mieux.	standard
telegramUserId	String	Votre ID Telegram pour les alertes (mode monitor uniquement).	--
telegramNotificationLimit	Integer	Nombre max de notifications Telegram par execution (anti-spam).	10
webhookUrl	String	URL HTTPS qui reçoit un lot JSON uniquement quand de nouvelles annonces sont livrées (mode Monitor).	--
webhookSecret	String	Secret optionnel pour signer les requetes via header X-Webhook-Signature (HMAC-SHA256).	--
webhookNotificationLimit	Integer	Nombre max d'annonces incluses dans le payload du webhook. Au-dela, le tableau est tronque.	100
includeSeller	Boolean	Profils vendeurs detailles (taux de reponse, badges, avis), factures separement.	true

Exemple de resultat

{
  "list_id": 2891456723,
  "title": "Maison 5 pieces 120m2 avec jardin",
  "price": 385000,
  "price_cents": 38500000,
  "location": "Bordeaux 33000",
  "city": "Bordeaux",
  "zipcode": "33000",
  "department_name": "Gironde",
  "region_name": "Aquitaine",
  "latitude": 44.84088,
  "longitude": -0.58064,
  "url": "https://www.leboncoin.fr/ad/ventes_immobilieres/2891456723.htm",
  "images": ["https://img.leboncoin.fr/api/v1/lbcimage/..."],
  "first_publication_date": "2026-03-05T14:30:00.000Z",
  "real_estate_type": "Maison",
  "rooms": 5,
  "bedrooms": 3,
  "square": 120,
  "land_square": 450,
  "energy_rate": "C",
  "ges": "D",
  "floor_property": null,
  "elevator": false,
  "furnished": false,
  "seller_name": "Agence Immobiliere Bordeaux",
  "seller_type": "pro",
  "seller_siren": "123456789",
  "phone": "+33612345678",
  "has_phone": true
}

Mode surveillance

Collez une URL de recherche leboncoin.fr valide et choisissez mode: "monitor". L'URL définit toute la recherche ; les filtres manuels sont ignorés et l'ordre du plus récent au plus ancien est imposé.

Exécution	Dataset et facturation	Notifications
Première	Crée une référence bornée et retourne jusqu'à adLimit annonces de référence, facturées normalement.	Aucune
Suivante, aucune nouveauté	Retourne uniquement un résumé non facturé.	Aucune
Suivante, nouveautés	Retourne et facture jusqu'à adLimit nouvelles annonces. Le surplus reste en attente uniquement tant qu'il apparaît dans le scan borné, du plus récent au plus ancien.	Un lot webhook et/ou alertes Telegram pour les annonces livrées

Les annonces confirmées ne sont pas livrées à nouveau. L'historique persiste sans expiration automatique et reste séparé pour chaque acteur et URL canonique. Réordonner les paramètres conserve l'historique ; modifier un filtre important en crée un autre. Aucune réinitialisation publique n'est actuellement disponible.

La première référence est bornée. Une ancienne annonce située hors de ce scan peut apparaître comme nouvelle si elle entre ensuite dans les résultats observés. La livraison n'est pas garantie exactement une fois : si une exécution s'arrête après la livraison et avant sa confirmation, une annonce peut réapparaître. Dédupliquez par (attempt_id, list_id). event_id identifie uniquement un lot identique ; une capacité différente peut créer un autre event_id.

Une annonce en attente est abandonnée après trois scans complets où elle est absente. La surveillance est au mieux : ni zéro annonce manquée ni la livraison finale ne sont garantis.

English summary: The first run returns a billed, notification-silent bounded baseline. Later runs check newest-first and deliver up to adLimit. Overflow remains pending only while it appears in that bounded scan, then is dropped after three complete misses. Monitoring is best-effort; zero missed listings and eventual delivery are not guaranteed. Each canonical URL history persists without automatic expiry, and no public reset is currently available. Webhooks are best-effort, are attempted only for delivered ads, retry only within the current run, and are not replayed automatically after failure. Their payload includes attempt_id, event_id, count, total_detected, and truncated. Delivery is not exactly once. event_id covers only an identical batch; across capacity changes, deduplicate each ad by (attempt_id, list_id).

Configuration

{
  "searchUrl": "https://www.leboncoin.fr/recherche?category=9&locations=Bordeaux__44.84088_-0.58064_5571&real_estate_type=1&price=150000-400000&rooms=3-max",
  "mode": "monitor",
  "telegramUserId": "123456789",
  "telegramNotificationLimit": 10,
  "adLimit": 100
}

Planifier l'execution automatique

1. Lancez l'acteur une premiere fois avec mode: "monitor" pour initialiser la baseline
2. Allez dans l'onglet Schedules de votre compte Apify
3. Cliquez Create new schedule
4. Selectionnez cet acteur et collez votre configuration JSON
5. Definissez la frequence : */15 * * * * (toutes les 15 minutes) ou 0 */2 * * * (toutes les 2 heures)
6. Activez le schedule

Configuration Telegram

1. Envoyez /start a @userinfobot pour obtenir votre ID
2. Renseignez votre ID dans telegramUserId
3. Les nouvelles annonces sont envoyees directement dans Telegram

Webhook (Make, Zapier, n8n, serveur custom)

Un lot JSON est tenté à webhookUrl uniquement lorsqu'une exécution Monitor livre de nouvelles annonces. Il n'y a aucun envoi lors de l'initialisation ou d'une exécution sans nouveauté. L'envoi est au mieux : la nouvelle tentative reste dans l'exécution courante et un échec n'est pas rejoué automatiquement plus tard.

{
  "event": "new_ads_batch",
  "attempt_id": "monitor_attempt_v1_...",
  "event_id": "monitor_event_v1_...",
  "actor": "clearpath/leboncoin-immobilier",
  "run_id": "abc123",
  "detected_at": "2026-05-26T11:30:00Z",
  "count": 5,
  "total_detected": 5,
  "truncated": false,
  "ads": [
    { "list_id": 1234567890, "title": "...", "price": 350, "url": "...", "city": "...", "...": "..." }
  ]
}

Verification de signature (optionnel) — si webhookSecret est renseigne, chaque requete inclut un header :

X-Webhook-Signature: sha256=<hex>

calcule par HMAC-SHA256(secret, raw_body). Recalculez le meme HMAC cote serveur et comparez pour rejeter les requetes non authentiques.

Tronquage — au-dela de webhookNotificationLimit (defaut 100), le tableau ads est tronque et le champ truncated passe a true.

Configuration type :

{
  "searchUrl": "https://www.leboncoin.fr/recherche?category=12&locations=Nice__43.70094_7.26839_9235&price=500-2500",
  "mode": "monitor",
  "webhookUrl": "https://hook.eu1.make.com/abc123",
  "webhookSecret": "mon_secret_partage"
}

Integration API

Python

from apify_client import ApifyClient

client = ApifyClient("your_token")
run = client.actor("clearpath/leboncoin-immobilier").call(run_input={
    "immobilierCategory": "9",
    "location": "Paris",
    "real_estate_type": ["1", "2"],
    "price_min_filter": 200000,
    "price_max_filter": 600000,
    "rooms_min": 2,
    "adLimit": 500
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{item['title']} - {item['price']}EUR - {item['location']}")

JavaScript

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'your_token' });
const run = await client.actor('clearpath/leboncoin-immobilier').call({
    immobilierCategory: '10',
    location: 'Lyon 69',
    real_estate_type: ['2'],
    price_max_filter: 1500,
    furnished: '1',
    adLimit: 200
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`${items.length} annonces trouvees`);

FAQ

Faut-il un compte leboncoin.fr ? Non, sauf pour l'extraction des numeros de telephone. Un compte gratuit suffit.

Combien d'annonces peut-on scraper ? Choisissez une valeur positive pour adLimit (minimum 10). Les recherches n'ont pas de plafond fixe imposé par cet acteur ; la collecte s'arrête au nombre demandé, aux résultats disponibles ou au budget de l'exécution.

Comment sont factures les numeros de telephone ? 9,99 $ / 1 000 numeros, et uniquement les numeros effectivement trouves. Aucun quota mensuel.

Les filtres immobiliers fonctionnent-ils avec l'URL de recherche ? Oui. Vous pouvez utiliser soit l'URL de recherche (tous les filtres sont extraits automatiquement), soit les filtres manuels. L'URL est prioritaire.

Quelle est la difference avec le scraper leboncoin generique ? Cet acteur ajoute 15+ filtres immobiliers (type de bien, surface, DPE, etage, exterieur), l'extraction de numeros de telephone (option facturée par numéro trouvé), le profil vendeur automatique, et un mode surveillance optimise pour l'immobilier.

Peut-on exporter vers un CRM immobilier ? Oui, via Zapier, Make ou n8n. Exportez en JSON, CSV ou Excel vers Apimo, Hektor, Immofacile ou tout autre CRM.

Retours et suggestions

• Bug ou probleme ? Ouvrez une issue dans l'onglet Issues
• Suggestion ou demande de fonctionnalite ? Meme endroit, l'onglet Issues
• Contact : max@mapa.slmail.me

Conformite

Cet acteur extrait des donnees publiquement accessibles sur leboncoin.fr. Les utilisateurs sont responsables du respect des conditions d'utilisation de leboncoin.fr et du RGPD.