Leboncoin Acheteur | Messagerie & Inbox Automatisées

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 à l’immobilier.

Pourquoi choisir cet actor ?

Votre messagerie Leboncoin, pilotée par API. Envoyez un message à un vendeur depuis votre application ou votre automatisation. Pour une sélection d’annonces, transmettez le même message à jusqu’à 10 vendeurs par exécution, avec un résultat pour chaque annonce.

Les réponses reliées aux annonces. Récupérez votre boîte de réception avec le dernier message, le nombre de messages non lus, le nom du correspondant et l’annonce concernée. Retrouvez les échanges à suivre sans perdre leur contexte.

Des conversations exploitables. Exportez le texte des messages, les dates, les informations sur les pièces jointes et les statuts de lecture disponibles. Choisissez l’ordre chronologique et le nombre de messages à récupérer pour votre suivi ou votre archivage.

Essayez avec une annonce

Remplacez l’URL par l’annonce du vendeur que vous souhaitez contacter, puis adaptez le message. Ajoutez l’e-mail et le mot de passe de votre compte Leboncoin dans le formulaire, avec le mot de passe dans le champ secret. L’action sendMessage envoie réellement le texte au vendeur lorsque vous lancez l’actor.

{
  "action": "sendMessage",
  "adUrl": "https://www.leboncoin.fr/ad/electromenager/3154283009",
  "message": "Bonjour, est-ce que cet article est toujours disponible ?"
}

Ouvrir les paramètres pour préparer votre message. Si Leboncoin demande une vérification SMS ou e-mail, relancez avec le code reçu dans twoFactorCode.

Pour consulter les réponses, utilisez fetchInbox. Son résultat fournit le conversation_id à renseigner dans conversationId avec fetchConversation pour exporter les messages. Le formulaire permet jusqu’à 500 conversations et 2 000 messages par conversation.

L’accès commence par un essai de 24 heures, puis un pass de 30 jours à 29 USD, activé après authentification au premier lancement éligible suivant l’essai. Aucun renouvellement sans nouveau lancement après expiration. Les frais de démarrage restent applicables : voir la tarification.

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

Copy to your AI assistant

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

clearpath/leboncoin-acheteur on Apify. Call: ApifyClient("TOKEN").actor("clearpath/leboncoin-acheteur").call(run_input={...}), then client.dataset(run["defaultDatasetId"]).list_items().items for results. Key inputs: action (string, required: "sendMessage"|"fetchInbox"|"fetchConversation"), email (string), password (string, secret), adUrl/adUrls for sendMessage, conversationId for fetchConversation (required; obtained from a prior fetchInbox run's conversation_id field; fetchConversation returns one record per message), twoFactorCode (optional string, secret; use on second run if leboncoin sends an SMS or email verification code). Error handling: every result has status ("success"|"skipped"|"error"); on error read error_code (SESSION_INVALID = account rejected/blocked, stop using it and do not retry; RATE_LIMITED = back off 15-30 min; INVALID_REQUEST = fix content; ACCESS_DENIED/SEND_FAILED = transient, retry once). Blocking is per leboncoin account (sending behavior), not per connection, so proxies do not prevent it; space sends 30-60s and use aged, complete accounts. Pricing: 24-hour free trial (no card required) starting from your first authenticated run, then custom 30-day pass at $29, charged only after the trial expires and only on a run with successful authentication when no active pass exists. The pass requires the run's max charge to allow at least $29. No automatic renewal: if the user does not run the actor after expiry, nothing is charged. Full actor spec (input schema with all params/enums/defaults, output dataset fields, README): GET https://api.apify.com/v2/acts/clearpath~leboncoin-acheteur/builds/default (Bearer TOKEN) → inputSchema, actorDefinition.storages.dataset, readme. Get token: https://console.apify.com/account/integrations

Fonctionnalités

• sendMessage — Envoyer un message à un ou plusieurs vendeurs (batch, jusqu'à 10 annonces)
• fetchInbox — Consulter vos conversations avec pagination automatique
• fetchConversation — Récupérer les messages d'une conversation dans la limite configurée, message par message
• makeOffer — Faire une offre de prix (bientôt disponible)
• buyNow — Acheter un article en remise en main propre (bientôt disponible)

Cas d'usage

• Chasseurs de voitures et d'immobilier — contactez en lot tous les vendeurs d'un modèle ou d'un secteur et proposez directement un échange téléphonique pour aller plus vite. Exemple de message : « Bonjour, votre annonce m'intéresse beaucoup. Seriez-vous disponible pour en discuter par téléphone ? »
• Suivi et négociation — repérez les réponses des vendeurs avec fetchInbox, puis relisez l'échange complet avec fetchConversation avant de relancer.
• Archivage — exportez l'historique complet de vos conversations pour vos dossiers ou votre suivi.

Tarification

Essai gratuit de 24 heures, puis pass mensuel de 29 USD pour 30 jours d'accès. Pas de renouvellement automatique, pas d'abonnement caché. L'essai et le pass sont liés à votre utilisateur Apify.

• Essai : déclenché automatiquement au premier run authentifié. Gratuit, sans carte, une seule fois par utilisateur Apify.
• Pass : activé au premier run authentifié après l'expiration de l'essai. Le max charge du run doit autoriser au moins 29 USD. Les runs suivants pendant 30 jours ne déclenchent aucun paiement.
• Aucun login réussi = aucun pass : si l'authentification échoue (2FA, identifiants invalides, compte bloqué), aucun pass n'est activé et les 29 USD ne sont pas facturés. Seul le démarrage du run reste facturé (0,005 USD). Si le pass expire et que vous ne relancez rien, vous ne payez plus rien.
• Démarrage du run : 0,005 USD par exécution, que le run aboutisse ou non.

Les logs du run indiquent l'état en cours : essai démarré, essai actif, pass actif, ou pass venant d'être activé.

Sécurité des identifiants

Aucune donnée personnelle n'est conservée par cet actor. Vos identifiants sont protégés à chaque étape :

• Mot de passe saisi via le champ sécurisé d'Apify (Secret input), masqué dans l'interface et les logs, jamais stocké en clair
• Sessions chiffrées AES-256 avant stockage
• Stockage isolé dans un espace développeur inaccessible aux utilisateurs et aux tiers
• Email hashé (SHA-256) comme identifiant de stockage, votre adresse n'est jamais stockée directement
• Aucune collecte de données personnelles, d'historique de navigation ou de contenu de messages

Démarrage rapide

Envoyer un message à un vendeur

{
  "action": "sendMessage",
  "email": "votre@email.fr",
  "password": "votre_mot_de_passe",
  "adUrl": "https://www.leboncoin.fr/ad/electromenager/3154283009",
  "message": "Bonjour, est-ce que cet article est toujours disponible ?"
}

Envoyer un message à plusieurs vendeurs (batch)

{
  "action": "sendMessage",
  "email": "votre@email.fr",
  "password": "votre_mot_de_passe",
  "adUrls": [
    "https://www.leboncoin.fr/ad/electromenager/3154283009",
    "https://www.leboncoin.fr/ad/informatique/3009018574"
  ],
  "message": "Bonjour, cet article est-il toujours disponible ?",
  "senderName": "Marie"
}

Consulter la boîte de réception

{
  "action": "fetchInbox",
  "email": "votre@email.fr",
  "password": "votre_mot_de_passe",
  "inboxLimit": 20
}

Récupérer l'historique d'une conversation

Lancez d'abord fetchInbox pour obtenir l'conversation_id d'une conversation, puis utilisez-le ici pour récupérer tous les messages échangés.

{
  "action": "fetchConversation",
  "email": "votre@email.fr",
  "password": "votre_mot_de_passe",
  "conversationId": "b7e4f2a1-3c89-4d12-a5b6-789012345678"
}

Code de vérification / 2FA

Si leboncoin demande un code de vérification, l'actor fonctionne en deux lancements :

1. Lancez l'actor normalement, sans twoFactorCode.
2. L'actor demande le code SMS ou email à leboncoin, stocke la session de vérification chiffrée, puis s'arrête avec un message indiquant que le code a été envoyé.
3. Relancez le même input avec le dernier code reçu dans twoFactorCode, idéalement dans les 15 minutes.

{
  "action": "fetchInbox",
  "email": "votre@email.fr",
  "password": "votre_mot_de_passe",
  "twoFactorCode": "123456"
}

Paramètres d'entrée

Requis

Paramètre	Type	Description
action	String	Action à effectuer : sendMessage, fetchInbox, fetchConversation, makeOffer*, buyNow*
email	String	Email de votre compte leboncoin.fr
password	String	Mot de passe (champ Secret input Apify, masqué et chiffré)

Optionnels

Paramètre	Type	Actions	Description	Défaut
adUrl	String	sendMessage, makeOffer*, buyNow*	URL de l'annonce cible	—
adUrls	Array	sendMessage	Plusieurs URLs en lot (max 10). Remplace adUrl si renseigné	—
message	String	sendMessage	Message au vendeur, max 2500 caractères	—
senderName	String	sendMessage	Nom affiché au vendeur dans la conversation	—
twoFactorCode	String	Toutes	Code de vérification SMS/email / 2FA. Utilisez-le seulement au deuxième lancement, après que l'actor a demandé le code	—
inboxLimit	Integer	fetchInbox	Nombre max de conversations à récupérer	50
includeContactedAds	Boolean	fetchInbox	Inclure la liste des annonces auxquelles vous avez déjà répondu	false
conversationId	String	fetchConversation	ID de la conversation à récupérer (depuis un résultat fetchInbox)	—
messageOrder	String	fetchConversation	Ordre des messages : asc (plus ancien d'abord) ou desc	asc
messageLimit	Integer	fetchConversation	Nombre max de messages à récupérer	1000
offerPrice	Number	makeOffer*	Prix proposé en euros	—

* Bientôt disponible

Exemples de résultats

sendMessage

{
  "action": "sendMessage",
  "ad_id": "3154283009",
  "ad_url": "https://www.leboncoin.fr/ad/electromenager/3154283009",
  "status": "success",
  "conversation_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message_id": "msg-uuid",
  "reply_channel": "knocker",
  "partner_name": "Jean"
}

fetchInbox

{
  "action": "fetchInbox",
  "conversation_id": "b7e4f2a1-3c89-4d12-a5b6-789012345678",
  "has_integration": false,
  "item_id": "3154283009",
  "item_type": "ad",
  "item_status": "active",
  "item_title": "Machine à laver Samsung",
  "item_price": "150",
  "item_image": "https://img.leboncoin.fr/api/v1/lbcpb1/images/12/34/56/...",
  "item_owner_id": "c9d8e7f6-5a4b-3c2d-1e0f-abcdef012345",
  "item_owner_type": "private",
  "partner_name": "Sophie",
  "partner_id": "d1e2f3a4-5b6c-7d8e-9f0a-bcdef1234567",
  "last_message": "Bonjour, toujours disponible ?",
  "last_message_date": "2026-03-04T10:30:00Z",
  "unseen_count": 1,
  "presence_status": "online",
  "status": "success"
}

Avec includeContactedAds: true, des entrées supplémentaires sont ajoutées :

{
  "action": "fetchInbox",
  "type": "contacted_ad",
  "list_id": "3154283009",
  "conversation_id": "b7e4f2a1-3c89-4d12-a5b6-789012345678",
  "status": "success"
}

fetchConversation

Un enregistrement par message, dans l'ordre chronologique. outgoing vaut true pour vos messages, false pour ceux du vendeur.

{
  "action": "fetchConversation",
  "conversation_id": "b7e4f2a1-3c89-4d12-a5b6-789012345678",
  "message_id": "66b19200-1728-11f1-8080-808080808080",
  "text": "Bonjour, est-ce que cet article est toujours disponible ?",
  "message_type": "ApiTextMessage",
  "message_date": "2026-03-03T17:42:51+0000",
  "sent_at": "2026-03-03T17:42:51.424Z",
  "outgoing": true,
  "read": true,
  "partner_read": true,
  "attachments": [],
  "status": "success"
}

En cas d'erreur, chaque action retourne "status": "error", un champ "error" lisible et un champ error_code stable, conçu pour être traité automatiquement par votre pipeline :

error_code	Signification	Action recommandée
SESSION_INVALID	Le compte a été rejeté (parfois bloqué par leboncoin)	Cessez d'utiliser ce compte, ne relancez pas en boucle, vérifiez-le
RATE_LIMITED	Limite d'envois atteinte côté leboncoin	Mettez ce compte en pause 15–30 min avant de renvoyer
INVALID_REQUEST	Message ou offre invalide	Corrigez le contenu
ACCESS_DENIED	Accès temporairement refusé	Nouvel essai possible
SEND_FAILED	Échec transitoire	Réessayez une fois, puis passez à l'annonce suivante

Éviter les blocages de compte

Le blocage intervient au niveau du compte leboncoin (selon son comportement d'envoi), pas au niveau de la connexion : changer de connexion ne l'empêche pas. Ce qui réduit réellement les blocages :

• Arrêtez tout compte renvoyant SESSION_INVALID : ne le relancez pas en boucle, mettez-le de côté.
• Espacez les envois : 30 à 60 s entre deux messages d'un même compte, avec un délai variable.
• Montez le volume progressivement : commencez à ~15–20 envois/jour par compte, augmentez sur plusieurs jours.
• Laissez les comptes se reposer : ne sollicitez pas tous les comptes à chaque cycle.
• Envoyez en journée, pas 24h/24 : une activité continue et régulière est un signal d'automatisation.
• Ne contactez jamais deux fois le même vendeur ou la même annonce.
• Préchauffez les nouveaux comptes : connectez-vous, naviguez, enregistrez quelques annonces, envoyez une réponse authentique, attendez un jour.
• Variez le texte de vos messages.
• Privilégiez des comptes anciens et complets (profil rempli, téléphone vérifié) : c'est le levier le plus efficace.

Limites connues

• Batch : maximum 10 URLs par exécution pour sendMessage
• Volume recommandé : pas plus de 50 messages par jour et par compte pour éviter tout signalement par leboncoin
• makeOffer / buyNow : le code est prêt, ces actions seront activées prochainement

FAQ

Mes identifiants sont-ils en sécurité ? Oui. Le mot de passe est saisi via le champ sécurisé d'Apify (masqué dans l'interface et les logs) et n'est jamais stocké. Les sessions sont chiffrées AES-256. Aucune donnée personnelle n'est conservée par cet actor.

Comment fonctionne l'essai gratuit ? Votre premier run authentifié déclenche automatiquement un essai gratuit de 24 heures. Aucune carte, aucun budget requis pendant cette période. Tous les actions disponibles sont accessibles. L'essai est utilisable une seule fois par utilisateur Apify.

Comment fonctionne le pass 30 jours ? Une fois l'essai gratuit terminé, le prochain run authentifié active un pass de 30 jours pour 29 USD. Après expiration du pass, un nouveau pass est activé seulement au prochain run authentifié. Il n'y a pas de renouvellement en arrière-plan.

Que se passe-t-il si mon max charge est inférieur à 29 USD à la fin de l'essai ? Le run échoue avec un message vous demandant de relever la limite de coût du run (max charge) à au moins 29 USD, puis de relancer.

Combien de messages puis-je envoyer ? Jusqu'à 10 par exécution via le mode batch. Vous pouvez lancer plusieurs exécutions successives. Pour rester du bon côté et éviter tout signalement par leboncoin, nous recommandons de ne pas dépasser 50 messages par jour et par compte.

Que se passe-t-il si ma session expire ? L'actor gère automatiquement le renouvellement de session. Aucune intervention manuelle nécessaire.

Que se passe-t-il si leboncoin demande un code de vérification ? L'actor déclenche l'envoi du code SMS ou email, puis s'arrête. Relancez-le avec le dernier code reçu dans twoFactorCode. Si le code est invalide, vous verrez Code de vérification / 2FA invalide. Si le code est trop ancien ou que la session de vérification n'existe plus, relancez d'abord sans code pour demander un nouveau code.

Puis-je utiliser un compte professionnel ? Oui, tout compte leboncoin.fr fonctionne (particulier ou professionnel).

Quand makeOffer et buyNow seront-ils disponibles ? Ces fonctionnalités sont en cours de finalisation. Suivez les mises à jour et soumettez vos demandes via l'onglet Issues.

Retours et suggestions

Cet actor est en bêta. Vos retours sont essentiels pour améliorer l'outil.

• Bug ou problème ? Ouvrez une issue dans l'onglet Issues
• Suggestion ou demande de fonctionnalité ? Même endroit, l'onglet Issues
• Contact : max@mapa.slmail.me

Conformité

Cet actor interagit avec leboncoin.fr via votre propre compte. L'utilisateur est responsable du respect des conditions d'utilisation de leboncoin.fr et de la réglementation applicable (RGPD).