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.

À partir du 31 octobre 2026, vous payez à l’usage : 0,07 USD par message envoyé et 0,007 USD par lecture de la boîte de réception ou d’une conversation. Les 10 premiers messages et les 10 premières lectures sont offerts. Un envoi échoué, ignoré ou bloqué n’est pas facturé. Jusqu’au 30 octobre, l’accès reste un essai de 24 heures puis un pass de 30 jours à 29 USD, et un pass déjà acheté reste valable jusqu’à sa date de fin. Détails : tarification.

Clearpath · Leboncoin Suite

Acheteur Vous êtes ici  Annonces Recherche & détails  Voitures Marque, modèle, km  Immobilier Biens & DPE  Téléphones Contacts vendeurs

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"); "skipped" means the ad is unavailable and NO message was sent (read reason_code: AD_UNAVAILABLE = detected before any send, AD_DELETED = leboncoin returned gone at send time, nothing created), and a run where every ad is skipped still succeeds; 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 from 2026-10-31: first 10 messages and first 10 reads free once per Apify user, then $0.07 per message actually sent (failed, skipped and blocked sends are free), $0.007 per successful fetchInbox or fetchConversation run, plus $0.005 per run start; a 30-day pass bought before then stays valid to its end with no per-message or read charges. The actor never sends a message the run's max charge cannot cover: remaining ads come back as "skipped" with reason_code CHARGE_LIMIT_REACHED. Until 2026-10-30: 24-hour free trial, then a 30-day pass at $29 (the run's max charge must allow at least $29). 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

À partir du 31 octobre 2026, vous payez à l'usage. Plus de pass, pas d'abonnement.

• Offert : vos 10 premiers messages envoyés et vos 10 premières lectures, une seule fois par utilisateur Apify, sans carte ni budget.

• Message envoyé : 0,07 USD par message effectivement envoyé à un vendeur. Un envoi échoué, ignoré (annonce indisponible) ou refusé parce que le compte est bloqué n'est pas facturé.

• Lecture : 0,007 USD par exécution réussie de fetchInbox ou fetchConversation, quel que soit le nombre de conversations ou de messages renvoyés.

• Démarrage du run : 0,005 USD par exécution, que le run aboutisse ou non.

• Limite de coût (max charge) : l'actor n'envoie jamais un message que la limite du run ne couvre pas. Les annonces restantes sont renvoyées en skipped avec reason_code: CHARGE_LIMIT_REACHED.

• Pass déjà acheté : il reste valable jusqu'à sa date de fin, sans frais par message ni par lecture.

Jusqu'au 30 octobre 2026 : essai gratuit de 24 heures, puis pass de 29 USD pour 30 jours, activé au premier run authentifié après l'essai. Le max charge du run doit autoriser au moins 29 USD. Si l'authentification échoue, le pass n'est pas facturé. Pas de renouvellement automatique.

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

Une annonce qui n'est plus disponible n'est pas une erreur : l'actor retourne "status": "skipped" avec un champ reason_code stable. Dans les deux cas, aucun message n'a été envoyé et aucune conversation n'a été créée, vous pouvez donc réessayer plus tard sans risque de doublon. Le run reste en succès, même si toutes les annonces sont ignorées.

reason_code	Signification	Message envoyé ?
AD_UNAVAILABLE	L'annonce n'est plus active (en pause, expirée) ; détecté avant tout envoi	Non
AD_DELETED	L'annonce a été supprimée entre la vérification et l'envoi	Non

Seul "status": "error" indique un résultat réellement incertain : lisez alors error_code ci-dessus.

É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.

Combien coûtent 100 messages ? 7 USD (100 × 0,07 USD), plus 0,005 USD par exécution. Les messages non envoyés ne sont pas facturés, et vos 10 premiers messages sont offerts.

J'ai acheté un pass avant le 31 octobre, que se passe-t-il ? Il reste valable jusqu'à sa date de fin, sans frais par message ni par lecture. Ensuite, vous payez à l'usage.

Que se passe-t-il si ma limite de coût (max charge) est atteinte ? L'actor s'arrête avant tout message que la limite ne couvre pas. Les annonces restantes sont renvoyées en skipped avec reason_code: CHARGE_LIMIT_REACHED : relevez la limite puis relancez-les.

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).