Meilleure API Leboncoin pour scraper des données à grande échelle

⚡ Résumé en 30 secondes

1. L'API officielle, c'est l'API Argus®, côté leboncoin auto. Elle cote les véhicules à la plaque. Pas d'endpoint de recherche, pas d'endpoint d'annonce, rien en dehors de l'auto... et même un compte de test exige un contrat annuel
2. Le faire toi-même, ça meurt vite. Une des protections anti-bot les plus strictes d'Europe, activement maintenue. Et même en passant, tu paies des proxies résidentiels à vie
3. lobstr.io (le meilleur choix global) ... tient à gros volume : 6 endpoints pour le scraping et l'automatisation, une fiabilité publiée scraper par scraper, 2 $ les 1 000 à grande échelle. Le hic : c'est asynchrone, et lent par worker
4. Piloterr (la meilleure option sync) ... uniquement les données d'annonces, mais un seul GET les renvoie, 20 annonces/min, à partir de 5,44 $ les 1 000. Le hic : aucun numéro de téléphone, aucune réputation vendeur

Dis-moi juste laquelle choisir

Deux de ces trois colonnes sont de vraies options. Voici pourquoi la première n'en est pas une, et quoi faire à la place.

Leboncoin propose-t-il une API ?

C'est du vrai travail d'ingénierie : RESTful, OAuth 2.0, JSON:API, versionnée en 3.0 et 3.1, avec un catalogue d'erreurs, une spec YAML et un guide de migration depuis leur ancien webservice.

Et c'est aussi totalement inutile pour ce que tu veux faire.

Ce qu'elle fait vraiment

Le référentiel Argus® est une base de données de véhicules.

Dans les mots de Leboncoin, il sert à « décrire et définir rigoureusement un véhicule VN/VO par sa génération, sa motorisation, sa finition commerciale, son prix, ses caractéristiques », et il vise « constructeurs, loueurs, assureurs, concessionnaires, infomédiaires ».

Tu lui donnes une plaque d'immatriculation française. Il te renvoie le véhicule.

Obtenir un accès, c'est le premier mur

Relis la dernière clause. Même un compte de test demande de signer un contrat annuel. Un contrat annuel... pour essayer. 🙃

Authentification

OAuth 2.0, tokens valables 120 minutes. Deux types de grant, selon que tu as un compte cote ou non.

Requête

curl --location 'https://api.leboncoin.auto/oauth/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'client_id=VOTRE_CLIENT_ID_ICI' \
--data-urlencode 'client_secret=<client_secret>' \
--data-urlencode 'type=part'
f

Réponse

{
  "access_token": "VOTRE_TOKEN",
  "token_type": "bearer",
  "expires_in": 7200,
  "created_at": 1495476696
}
f

Une vraie requête

Requête

curl --location 'https://api.leboncoin.auto/checkout/3.1/matchings' \
--header 'Authorization: Bearer VOTRE_TOKEN' \
--header 'Content-Type: application/vnd.api+json' \
--data '{
  "data": {
    "type": "matchings",
    "attributes": {
      "offer": "identification-by-registration",
      "registration": "dn386yt"
    }
  }
}'
f

Ensuite tu vas chercher le détail.

Requête

GET /checkout/3.1/matchings/{id}?include=candidates,registration-card

Là où elle s'arrête

Si tu es concessionnaire, assureur ou loueur et que tu cotes des véhicules, c'est sincèrement le bon outil et tu devrais l'utiliser. Il est bien conçu et il fait son travail.

Mais il ne peut pas te dire ce qui est en ligne sur Leboncoin en ce moment. Pas d'endpoint de recherche. Pas d'endpoint d'annonce. Aucune donnée vendeur.

Pas d'immobilier, pas de mobilier, pas d'emploi, rien en dehors de l'auto. Et aucune limite de débit ni tarif publié nulle part, parce que les deux dépendent du contrat et n'apparaissent qu'une fois leur équipe commerciale engagée.

Donc la porte officielle existe, elle est verrouillée, et elle donne sur une autre pièce.

Quelles autres options a-t-on ?

Voilà la pensée qui vient à tout développeur juste après. Pas d'API ? Très bien. J'ouvre les DevTools, je trouve les endpoints internes et je leur parle directement. Ou alors j'écris un scraper... un peu de parsing HTML, un navigateur headless, plié d'ici vendredi.

Ça ne marche pas.

Avoir les DevTools ouverts suffit à te faire repérer.

Et admettons que tu passes. Tu viens de signer pour trois coûts qui ne disparaîtront jamais :

1. Des proxies résidentiels, en continu. Les IP de datacenter sont filtrées bien plus durement, et du trafic français est attendu
2. De la maintenance permanente. Leboncoin déploie des changements sans prévenir et durcit sans arrêt sa couche anti-bot. Ton scraper ne casse jamais au moment où ça t'arrange
3. Une difficulté qui grimpe avec le volume. Les techniques qui survivent à 100 annonces par jour s'effondrent à 100 000, donc le correctif n'est jamais terminé

Et il y a encore un mur derrière celui-là. La donnée que la plupart des gens veulent vraiment, le numéro de téléphone du vendeur, se cache derrière un login.

Et Leboncoin déconnecte les comptes de façon agressive dès que tu commences à tirer des numéros en volume.

C'est exactement pour ça que des API tierces dédiées existent. Pas comme un raccourci, mais parce que la maintenance est le produit.

Mais laquelle est la meilleure pour scraper à grande échelle ?

Meilleure API Leboncoin : lobstr.io

Ce qu'elle propose

Six crawlers Leboncoin, chacun avec son endpoint, couvrant à la fois la collecte de données et l'automatisation.

Aucun autre fournisseur ne va au-delà de la recherche et du détail d'annonce. C'est la seule où le monitoring, les données d'entreprise B2B et la prise de contact sont des endpoints plutôt que des projets.

Fonctionnalités

1. La seule API Leboncoin qui renvoie le vrai numéro de téléphone du vendeur
2. Gestion multi-comptes, avec limites et temps de pause intégrés
3. Fiabilité publiée, scraper par scraper
4. Un dashboard no-code branché sur la même API
5. Planification intégrée, donc aucun cron à maintenir
6. Export vers CSV, Excel, JSON, JSONL, Google Sheets ou S3
7. Une doc développeur avec des exemples exécutables, plus un SDK, un CLI et un serveur MCP

Gestion multi-comptes. Connecte autant de comptes Leboncoin que nécessaire à un seul run, et quand l'un se fait déconnecter, il bascule tout seul sur le suivant.

Des limites intelligentes et des temps de pause gardent tes comptes hors de la liste des bannis, et si tous les comptes lâchent, le run se met en pause au lieu de mourir.

La stabilité est publiée, pas revendiquée. Chaque page produit de scraper affiche une section Built to run. avec un relevé en direct sur 90 jours.

Le chiffre que je regarderais, ce n'est pas le pourcentage, c'est la colonne 100 % résolu sur les six. N'importe qui peut publier un taux de disponibilité.

Publier son nombre d'incidents et son délai médian de correction par scraper, c'est rare.

Ce relevé, c'est aussi ce sur quoi repose le calcul de débit.

Le dashboard no-code. Ce n'est pas un produit séparé, c'est la même API avec une interface par-dessus. Un Squid créé en HTTP apparaît dans le dashboard, et un run lancé depuis le dashboard est lisible, modifiable et arrêtable via l'API.

Planification. Règle un Squid pour tourner toutes les heures, tous les jours ou toutes les semaines et il gère la cadence lui-même. Pas de cron, pas de worker à toi qui attend là pour déclencher une requête.

Exports. Les résultats reviennent en CSV, Excel, JSON ou JSONL, et peuvent être poussés directement vers Google Sheets, S3, SFTP, e-mail ou un webhook.

Coût

Abonnement mensuel à base de crédits, sans frais de dépassement, et aucun palier gratuit. Tous les crawlers Leboncoin sont payants, donc le ticket d'entrée est à 20 $ par mois.

Chaque crawler dépense ces crédits à son propre rythme, et le chiffre exact est dans la section de ce crawler plus bas.

Deux choses comptent plus que le prix affiché.

Les fonctions optionnelles se facturent aussi au succès. Si une annonce n'a pas de numéro, tu n'es pas facturé des 6 crédits pour avoir cherché. Pareil pour le profil vendeur, pareil pour chaque option.

Avantages et inconvénients

Comment utiliser l'API Leboncoin de lobstr.io

lobstr.io est asynchrone, donc avant que les endpoints aient du sens, il faut comprendre sa forme. Six étapes, dans l'ordre.

Crawler → Squid → Account → Task → Run → Result

Créer un Squid demande le hash du crawler, pas son slug, et rien ne te le dit tant que ça n'a pas échoué. Résous-le une bonne fois.

Requête

curl -X GET "https://api.lobstr.io/v1/crawlers" \
  -H "Authorization: Token YOUR_API_KEY"
f

Ou évite l'aller-retour. Voici les six.

Requête

curl -X GET "https://api.lobstr.io/v1/crawlers/33db1ca85160105eeb84d5aa51cfad10/params" \
  -H "Authorization: Token YOUR_API_KEY"
f

Il renvoie le format d'entrée accepté avec son regex de validation, chaque réglage que prend le crawler, et le coût en crédits de chaque fonction optionnelle. Tous les tableaux de paramètres de cet article viennent de là.

Étape 2 : Squid

Créer, puis configurer.

Requête

curl -X POST "https://api.lobstr.io/v1/squids" \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "crawler": "33db1ca85160105eeb84d5aa51cfad10",
    "name": "Leboncoin Paris apartments"
  }'
f

Réponse

{
  "id": "b6c56d18cb0046949461ba9ca278e8ad",
  "object": "squid",
  "name": "Leboncoin Paris apartments"
}
f

Requête

curl -X POST "https://api.lobstr.io/v1/squids/b6c56d18cb0046949461ba9ca278e8ad" \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "concurrency": 1,
    "export_unique_results": true,
    "no_line_breaks": true,
    "params": {
      "max_pages": 5,
      "max_results": 500,
      "fetch_since": "7d"
    }
  }'
f

Étape 3 : Account, mais seulement pour trois des six

Saute complètement cette étape pour Listings Search Export, Boutiques et Status Checker. Elle est obligatoire pour Listings & Phone Search Export, Listing Scraper et Auto Message Sender.

Via l'API, commence par demander ce qui est nécessaire.

Requête

curl -X GET "https://api.lobstr.io/v1/account_types" \
  -H "Authorization: Token YOUR_API_KEY"
f

Réponse

{
  "name": "leboncoin-sync",
  "domain": "Leboncoin",
  "baseurl": "https://auth.leboncoin.fr",
  "cookies": [
    { "name": "__Secure-Login", "required": true }
  ],
  "params": {
    "messages":    { "default": 5, "max": 30, "display": "Messages per day" },
    "batch":       { "default": 8, "max": 8,  "display": "Messages per batch" },
    "batch_hours": { "default": 1, "max": 2,  "display": "Pause hours between batches" }
  }
}
f

Un seul cookie obligatoire. Ensuite tu synchronises.

Requête

curl -X POST "https://api.lobstr.io/v1/accounts/cookies" \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "leboncoin-sync",
    "cookies": { "__Secure-Login": "YOUR_COOKIE_VALUE" }
  }'
f

Limites de compte

Le plafond est donc de 30 messages par jour, envoyés par batchs de 8, avec jusqu'à 2 heures de pause entre les batchs.

Tu peux réduire ces valeurs. Tu ne peux pas dépasser le max, et tu ne devrais pas vouloir le faire.

Requête

curl -X POST "https://api.lobstr.io/v1/accounts" \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account": "YOUR_ACCOUNT_HASH",
    "type": "leboncoin-sync",
    "params": {
      "messages": 20,
      "batch": 8,
      "batch_hours": 2
    }
  }'
f

Étape 4 : Task

Une task, c'est une URL, et un Squid en prend autant que tu veux lui en donner. Dix URL de recherche, dix tasks, un seul run.

Requête

curl -X POST "https://api.lobstr.io/v1/tasks" \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "squid": "b6c56d18cb0046949461ba9ca278e8ad",
    "tasks": [
      { "url": "https://www.leboncoin.fr/recherche?category=9&locations=Paris_75001" },
      { "url": "https://www.leboncoin.fr/recherche?category=9&locations=Lyon_69002" },
      { "url": "https://www.leboncoin.fr/recherche?category=9&locations=Bordeaux_33000" }
    ]
  }'
f

Requête

curl -X POST "https://api.lobstr.io/v1/tasks/upload" \
  -H "Authorization: Token YOUR_API_KEY" \
  -F "file=@tasks.csv" \
  -F "squid=b6c56d18cb0046949461ba9ca278e8ad"
f

Le TSV marche aussi, et c'est le choix le plus sûr pour des URL Leboncoin, parce que les URL de recherche sont pleines de virgules.

Chaque crawler valide son entrée contre un regex, donc une URL mal formée échoue ici plutôt qu'en plein run.

https://www.

Filtre d'abord sur Leboncoin, puis copie l'URL. Chaque paramètre de filtre est conservé.

Étape 5 : Run

Le lancement tient en un appel.

Requête

curl -X POST "https://api.lobstr.io/v1/runs" \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "squid": "b6c56d18cb0046949461ba9ca278e8ad" }'
f

Comme lobstr.io est asynchrone, ton job est en gros mis en file. Savoir quand il est terminé, c'est ça qui compte. Pour ça, tu peux interroger l'endpoint de stats du run.

Requête

curl -X GET "https://api.lobstr.io/v1/runs/300e9c5c127d421c90f431478d9a2cfb/stats" \
  -H "Authorization: Token YOUR_API_KEY"
f

Réponse

{
  "id": "300e9c5c127d421c90f431478d9a2cfb",
  "object": "run",
  "is_done": true,
  "percent_done": "100%",
  "eta": "∞",
  "duration": "0:00:15.175532",
  "total_tasks": 10,
  "total_tasks_done": 10,
  "total_tasks_left": 0,
  "total_results": 6
}
f

Étape 6 : Result

Deux façons de récupérer. Paginer le JSON, ou télécharger tout le run sous forme de fichier.

Requête

curl -X GET "https://api.lobstr.io/v1/results?squid=b6c56d18cb0046949461ba9ca278e8ad&page=1&limit=50" \
  -H "Authorization: Token YOUR_API_KEY"
f

Réponse

{
  "total_results": 3,
  "limit": 50,
  "page": 1,
  "total_pages": 1,
  "data": [ { "...": "crawler-specific result objects" } ],
  "next": null,
  "previous": null
}
f

Requête

curl -X GET "https://api.lobstr.io/v1/runs/300e9c5c127d421c90f431478d9a2cfb/download?file_format=xlsx" \
  -H "Authorization: Token YOUR_API_KEY"
f

Réponse

{
  "s3": "https://s3.eu-west-1.amazonaws.com/api.lobstr.io/temporary/..."
}
f

Les résultats sont conservés 28 jours. Ce qui veut dire qu'ils restent sur le serveur de lobstr.io pendant 28 jours à partir du jour du run. Tu peux les télécharger à tout moment durant cette période.

Requête

curl -X POST "https://api.lobstr.io/v1/delivery?squid=b6c56d18cb0046949461ba9ca278e8ad" \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@example.com",
    "notifications": true
  }'
f

Se passer complètement du polling

Requête

curl -X POST "https://api.lobstr.io/v1/delivery?squid=b6c56d18cb0046949461ba9ca278e8ad" \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "webhook_fields": {
      "url": "https://your-endpoint.com/lobstr",
      "is_active": true,
      "retry": true,
      "events": {
        "run.running": false,
        "run.paused": true,
        "run.done": true,
        "run.error": true
      }
    }
  }'
f

Limites de débit

Passons aux six crawlers, dans l'ordre où tu les voudras. J'ajoute pour chacun une courte intro, un cas d'usage, les paramètres et un script d'exemple.

1. Listings Search Export

Celui-ci sert à collecter des données d'annonces en masse depuis n'importe quelle URL de recherche ou de catégorie Leboncoin. Tu peux t'en servir pour du monitoring de marché, du suivi de prix, de l'analyse de stock.

Coût

1. 8,00 $ les 1 000 à l'entrée
2. 2,00 $ les 1 000 à grande échelle

Script complet

import requests, time

API_KEY = "YOUR_API_KEY"
BASE = "https://api.lobstr.io/v1"
headers = {"Authorization": f"Token {API_KEY}"}

squid = requests.post(f"{BASE}/squids", headers=headers, json={
    "crawler": "33db1ca85160105eeb84d5aa51cfad10",
    "name": "Leboncoin Paris apartments",
}).json()["id"]

requests.post(f"{BASE}/squids/{squid}", headers=headers, json={
    "export_unique_results": True,
    "params": {"max_pages": 5, "fetch_since": "7d"},
})

requests.post(f"{BASE}/tasks", headers=headers, json={
    "squid": squid,
    "tasks": [{"url": "https://www.leboncoin.fr/recherche?category=9&locations=Paris_75001"}],
})

run = requests.post(f"{BASE}/runs", headers=headers, json={"squid": squid}).json()["id"]

# Attends le scrape, puis l'export. Ils ne finissent pas en même temps.
while True:
    r = requests.get(f"{BASE}/runs/{run}", headers=headers).json()
    if r["is_done"] and r["export_done"]:
        break
    time.sleep(30)

print(f"{r['credit_used']} credits used")

results, page = [], 1
while True:
    batch = requests.get(f"{BASE}/results", headers=headers,
                         params={"squid": squid, "page": page, "limit": 50}).json()
    rows = batch.get("data", [])
    if not rows:
        break
    results.extend(rows)
    page += 1
    time.sleep(0.5)

print(f"{len(results)} listings")
f

Un résultat porte 115 champs de données, j'ai gardé ici les plus intéressants.

Réponse

{
  "ANNONCE ID": "3210370635",
  "TITLE": "4 pièces avec balcon sur parc proche transports",
  "PRICE": "390000",
  "PRICE PER SQUARE METER": "4875",
  "URL": "https://www.leboncoin.fr/ad/ventes_immobilieres/3210370635",
  "LAT": "48.91719",
  "LNG": "2.35385",
  "CITY": "Saint-Denis",
  "POSTAL CODE": "93210",
  "FIRST PUBLICATION DATE": "2026-06-04T14:25:11",
  "LAST PUBLICATION DATE": "2026-07-09T14:25:11",
  "HAS PHONE": "TRUE",
  "AREA": "80",
  "ROOM COUNT": "4",
  "DPE": "a",
  "GES": "a",
  "REAL ESTATE TYPE": "Appartement",
  "SELLER REGISTERED AT": "2016-12-15",
  "SELLER BADGES": "[\"Responsiveness2\", \"VerifiedPhoneNumber\"]"
}
f

2. Listings & Phone Search Export

Celui-ci, c'est le même export de recherche, plus le vrai numéro de téléphone du vendeur et un profil vendeur complet. Tu peux t'en servir pour de la génération de leads, de la prise de contact vendeur, la construction de listes de prospects joignables.

Il a besoin d'un compte Leboncoin synchronisé.

Coût

1. Annonces seules : 8,00 $ les 1 000 à l'entrée, 2,00 $ à grande échelle
2. Avec téléphone (le défaut) : 20,00 $ les 1 000 à l'entrée, 5,00 $ à grande échelle
3. Avec téléphone et profil vendeur : 28,00 $ les 1 000 à l'entrée, 7,00 $ à grande échelle

Les fonctions se facturent au succès. Une annonce sans numéro à trouver coûte 4 crédits, pas 10.

Script complet

accounts = requests.get(f"{BASE}/accounts", headers=headers).json()["data"]
account = next(a["id"] for a in accounts
               if a["type"] == "leboncoin-sync" and str(a["status"]) == "200")

squid = requests.post(f"{BASE}/squids", headers=headers, json={
    "crawler": "7bc4acdb18f2b90fdd5eb42b8e8251e9",
    "name": "Leboncoin leads",
}).json()["id"]

requests.post(f"{BASE}/squids/{squid}", headers=headers, json={
    "accounts": [account],
    "params": {
        "max_pages": 99,
        "fetch_since": "7d",
        "functions": {
            "get_phone_numbers": True,
            "get_seller_profile": True,
        },
    },
})
f

Il collecte toutes les données du Leboncoin Search Export + les données supplémentaires suivantes.

Réponse

{
  "ANNONCE ID": "3210370635",
  "HAS PHONE": "TRUE",
  "IS MOBILE": "TRUE",
  "PHONE": "+336XXXXXXXX",
  "SELLER REGISTERED AT": "2016-12-15",
  "SELLER TOTAL ADS": "2",
  "SELLER BADGES": "[\"Responsiveness2\", \"VerifiedPhoneNumber\"]",
  "PARAM GET PHONE NUMBERS": "TRUE",
  "PARAM GET SELLER PROFILE": "TRUE"
}
f

3. Listing Scraper

Celui-ci sert à scraper des URL d'annonces que tu as déjà, plutôt qu'à en découvrir de nouvelles.

Tu peux t'en servir pour enrichir une liste d'annonces existante, revérifier les prix sur des annonces connues, récupérer les numéros d'une shortlist.

https://www.leboncoin.fr/ad/...

Coût

1. Annonces seules : 8,00 $ les 1 000 à l'entrée, 2,00 $ à grande échelle
2. Avec téléphone (le défaut) : 20,00 $ les 1 000 à l'entrée, 5,00 $ à grande échelle

Script complet

squid = requests.post(f"{BASE}/squids", headers=headers, json={
    "crawler": "9eade2d2a693bd871851806650e7fb4e",
    "name": "Leboncoin listing enrichment",
}).json()["id"]

requests.post(f"{BASE}/squids/{squid}", headers=headers, json={
    "accounts": [account],
    "params": {"functions": {"get_phone_numbers": True}},
})

requests.post(f"{BASE}/tasks", headers=headers, json={
    "squid": squid,
    "tasks": [
        {"url": "https://www.leboncoin.fr/ad/ventes_immobilieres/3138320858"},
        {"url": "https://www.leboncoin.fr/ad/voitures/3172676206"},
    ],
})

requests.post(f"{BASE}/runs", headers=headers, json={"squid": squid})
f

Réponse

{
  "annonce_id": "3138320858",
  "title": "Appartement 6 pièces 212 m²",
  "url": "https://www.leboncoin.fr/ad/ventes_immobilieres/3138320858",
  "price": 3490000,
  "has_phone": true,
  "phone": "+331XXXXXXXX",
  "owner_name": "Junot Passy",
  "owner_type": "pro",
  "store_id": "84291829",
  "functions": {
    "get_phone_numbers": {
      "filling_date": "08/06/2026, 18:24:30 +0200"
    }
  },
  "scraping_time": "2026-08-06T16:24:30.994Z"
}
f

Ne suppose pas que ça reflète les exports de recherche. C'est 18 champs contre 115 : pas de coordonnées, pas d'attributs, pas de DPE, pas d'images. Tu récupères le noyau d'identité ... titre, prix, description, téléphone, vendeur. S'il te faut les attributs et la géoloc, pointe plutôt l'export de recherche sur une URL.

4. Boutiques Scraper

Celui-ci sert à collecter les boutiques des vendeurs professionnels, avec leur identité légale attachée.

Tu peux t'en servir pour de la prospection B2B, de la cartographie de concurrents, pour rapprocher les vendeurs Leboncoin des registres d'entreprises français.

Aucun compte nécessaire.

Coût

1. Boutiques seules : 2,00 $ les 1 000 à l'entrée, 0,50 $ à grande échelle
2. Avec détails : 6,00 $ les 1 000 à l'entrée, 1,50 $ à grande échelle
3. Avec détails et téléphone (le défaut) : 18,00 $ les 1 000 à l'entrée, 4,50 $ à grande échelle

Script complet

squid = requests.post(f"{BASE}/squids", headers=headers, json={
    "crawler": "c6e88128aef71c079e58f0518687e10c",
    "name": "Leboncoin boutiques",
}).json()["id"]

requests.post(f"{BASE}/squids/{squid}", headers=headers, json={
    "params": {
        "max_pages": 99,
        "functions": {"get_details": True, "get_phone_numbers": True},
    },
})

requests.post(f"{BASE}/tasks", headers=headers, json={
    "squid": squid,
    "tasks": [{"url": "https://www.leboncoin.fr/boutique/4308883"}],
})

requests.post(f"{BASE}/runs", headers=headers, json={"squid": squid})
f

Réponse

{
  "online_store_name": "007 agent i - Agence immobilière à Montmélian",
  "slogan": "007 AGENT-i : l'agence qui sort du lot",
  "siren": "902063700",
  "siret": "90206370000022",
  "sector": "property",
  "active_since": "2021-11-02T23:00:00Z",
  "address": "12 avenue de Savoie",
  "city": "Montmélian",
  "zipcode": "73800",
  "department_label": "Savoie",
  "lat": 45.50108,
  "lng": 6.05071,
  "has_phone": true,
  "phone": "04XXXXXXXX",
  "opening_hours": "Du lundi au vendredi, de 9h à 12h et de 14h à 18h.",
  "rating_value": 4.9,
  "rating_count": 152,
  "functions": {
    "get_details":       { "filling_date": "08/06/2026, 18:29:57 +0200" },
    "get_phone_numbers": { "filling_date": "08/06/2026, 18:30:44 +0200" }
  }
}
f

La suite offre donc deux voies de génération de leads. Les exports de recherche, c'est du B2C : vendeurs particuliers, numéros, réputation. Boutiques, c'est du B2B : entreprises immatriculées, identifiants d'entreprise, adresses physiques.

5. Listing Status Checker

Celui-ci sert à vérifier si une annonce est toujours en ligne. Tu peux t'en servir pour du monitoring de stock, mesurer le délai de vente, nettoyer les lignes mortes d'une base que tu as constituée plus tôt.

Aucun compte nécessaire, et c'est ce qu'il y a de moins cher dans la suite.

Coût

1. Vérifications de statut : 2,00 $ les 1 000 à l'entrée
2. 0,50 $ les 1 000 à grande échelle

Script complet

squid = requests.post(f"{BASE}/squids", headers=headers, json={
    "crawler": "0c60c33b95db65c86d5c9fc127b7b2aa",
    "name": "Leboncoin listing monitor",
}).json()["id"]

requests.post(f"{BASE}/squids/{squid}", headers=headers, json={"params": {}})

requests.post(f"{BASE}/tasks", headers=headers, json={
    "squid": squid,
    "tasks": [{"url": u} for u in listing_urls],
})

requests.post(f"{BASE}/runs", headers=headers, json={"squid": squid})
f

Réponse : annonce en ligne

{
  "url": "https://www.leboncoin.fr/ad/ventes_immobilieres/3138320858",
  "status": "active",
  "status_code": 200,
  "functions": null,
  "scraping_time": "2026-08-06T16:27:08.544Z"
}
f

Et quand l'annonce a disparu.

Réponse : annonce supprimée

{
  "url": "https://www.leboncoin.fr/ad/voitures/3172676206",
  "status": "deactivated",
  "status_code": 410,
  "functions": null
}
f

Rien ici n'est une donnée personnelle. Pas de nom de vendeur, pas de numéro, pas d'ID de propriétaire, donc tu peux surveiller des dizaines de milliers d'annonces indéfiniment et ne lancer les crawlers coûteux que sur celles qui bougent.

6. Auto Message Sender

Celui-ci sert à contacter les vendeurs via la messagerie de Leboncoin. Tu peux t'en servir pour sourcer du stock, contacter des vendeurs particuliers en volume, relancer après une recherche filtrée.

Il a besoin d'un compte Leboncoin synchronisé. Il prend une URL de recherche plutôt qu'une URL d'annonce, donc une seule task peut piloter toute une campagne.

Coût

1. 40,00 $ les 1 000 messages à l'entrée
2. 10,00 $ les 1 000 à grande échelle

Les 1 000, c'est l'arithmétique, pas le plan. Au plafond de 30 messages par jour, un compte synchronisé culmine autour de 900 messages par mois, donc 1 000 messages veut dire plus de comptes, pas un plan plus gros.

Script complet

squid = requests.post(f"{BASE}/squids", headers=headers, json={
    "crawler": "fa9c988768a3d61f358916400f3c4b65",
    "name": "Leboncoin outreach",
}).json()["id"]

requests.post(f"{BASE}/squids/{squid}", headers=headers, json={
    "accounts": [account],
    "params": {
        "message": (
            "Bonjour #PSEUDO#,\n\n"
            "Votre annonce #TITLE# m'intéresse. "
            "Est-elle toujours disponible ?\n\nMerci !"
        ),
        "fetch_since": "24h",
        "max_results": 20,
    },
})

requests.post(f"{BASE}/tasks", headers=headers, json={
    "squid": squid,
    "tasks": [{"url": "https://www.leboncoin.fr/recherche?category=9&locations=Paris_75001"}],
})

# Vérifie ton message et tes limites de compte avant cette ligne
requests.post(f"{BASE}/runs", headers=headers, json={"squid": squid})
f

Réponse

{
  "annonce_id": "3180087828",
  "url": "https://www.leboncoin.fr/ad/locations/3180087828",
  "message": "Hello [SELLER NAME],\n\nJe viens de voir votre article qui porte le nom:\nMaison 4 pièces 90 m²\n\nL'offre m'intéresse?\n...",
  "is_sent": true,
  "was_already_sent": true,
  "is_deactivated": false
}
f

Ou saute tout ça

Tout ce qui précède, c'est l'API brute, et ça vaut le coup de la connaître parce que c'est ce que ton code de production appellera. Pour poser un jeu de données sur ton disque cet après-midi, il y a un chemin plus court.

Le CLI ramène les six étapes à une ligne.

pip install lobstrio
lobstr go leboncoin-iter-listings \
  "https://www.leboncoin.fr/recherche?category=9&locations=Paris_75001" \
  -o listings.csv
f

Il y a aussi un mode pas à pas, si tu préfères piloter chaque étape toi-même.

lobstr crawlers search leboncoin
lobstr squid create leboncoin-boutique --name "Boutiques FR"
lobstr task add SQUID_ID "https://www.leboncoin.fr/boutique/4308883"
lobstr run start SQUID_ID --wait
lobstr results get SQUID_ID --format csv -o boutiques.csv
f

Le SDK Python est celui à sortir quand le scraper vit à l'intérieur d'une application.

pip install lobstrio-sdk
export LOBSTR_TOKEN=your_api_key
f

from lobstrio import LobstrClient

client = LobstrClient()

crawler = next(c for c in client.crawlers.list()
               if c.slug == "leboncoin-iter-listings")

squid = client.squids.create(crawler=crawler.id, name="Paris apartments")
client.squids.update(squid.id, params={"max_pages": 5, "fetch_since": "7d"})

client.tasks.add(squid=squid.id, tasks=[
    {"url": "https://www.leboncoin.fr/recherche?category=9&locations=Paris_75001"}
])

run = client.runs.start(squid=squid.id)
run = client.runs.wait(run.id, callback=lambda s: print(s.percent_done, s.eta))
print(f"{run.total_results} results, {run.credit_used} credits")

for listing in client.results.iter(squid=squid.id):
    print(listing["TITLE"], listing["PRICE"])
f

Le problème : c'est une API asynchrone

Tout ce qui précède partage une même forme. Tu soumets le travail, tu attends, tu récupères. Ça va très bien pour 100 000 annonces sur une planification. C'est inutile quand un utilisateur est devant un formulaire à attendre une réponse.

Si c'est ta situation, aucune richesse de données ne réglera le problème. Il te faut un autre type d'API.

Synchrone vs asynchrone

Une API synchrone renvoie les données dans la même réponse. Une requête en entrée, un résultat en sortie, rien à suivre.

Une API asynchrone renvoie un identifiant de job à la place. Le travail tourne sur l'infrastructure du fournisseur et tu récupères les résultats plus tard, par polling ou webhook.

Utilise une API sync si

1. Un utilisateur attend la réponse
2. Tu enrichis un seul enregistrement à la demande
3. Ton volume est modeste
4. Tu as déjà un ordonnanceur de jobs et tu veux que l'API reste un simple appel de fonction

Utilise une API async si

1. Le job porte sur des milliers ou des millions d'enregistrements
2. Il tourne sans surveillance, sur une planification
3. Il tourne assez longtemps pour qu'un timeout de requête le tue
4. Tout perdre en plein run est inacceptable

La conception asynchrone de lobstr.io est exactement ce qui lui permet de survivre à Leboncoin en volume, et exactement ce qui l'empêche de tenir derrière une recherche en direct. Si c'est ta situation, Piloterr est la réponse.

Meilleure API Leboncoin sync : Piloterr

Ce qu'elle propose

Fonctionnalités

1. Vraiment synchrone, un GET et les données sont dans la réponse
2. Le worker unique le plus rapide que j'ai mesuré, à 20 annonces par minute
3. Les données géo et image les plus riches de tout ce que j'ai testé
4. Des libellés français sur chaque attribut
5. Un serveur MCP d'exécution

Vraiment synchrone. Un GET, les données dans la réponse, rien à interroger. C'est toute la raison de la choisir, et c'est la seule chose que lobstr.io ne peut pas faire, à aucun prix.

Vitesse. 20 annonces par minute contre 3 à 4 pour lobstr.io. Sur quelques milliers d'enregistrements, cet écart décide de ton après-midi.

Géo et images. Géométrie GeoJSON complète, et toutes les tailles d'image, de la vignette au grand format. lobstr.io renvoie les coordonnées et une image principale, donc pour une carte ou une galerie, c'est le meilleur payload.

Ce qui manque

La reprise quand un run casse. Il s'arrête net sur erreur au lieu de se mettre en pause. lobstr.io met le run en pause et garde ce qu'il a déjà collecté, donc tu reprends ; ici, le batch se termine, et relancer depuis le début coûte des crédits une deuxième fois. Sur un job de 50 000 annonces, c'est la différence entre un retard et une réécriture.

La rétention des données. Piloterr ne stocke rien. La réponse HTTP est la seule copie, donc si ton écriture échoue avant que l'insertion soit validée, cet enregistrement est perdu et tu paies à nouveau pour le récupérer. lobstr.io conserve les résultats 28 jours.

Coût

1. Annonces : 5,44 $ les 1 000 à l'entrée, 3,76 $ les 1 000 au plancher publié
2. Recherche seule, en abandonnant l'appel /ad : 2,72 $ les 1 000 à l'entrée, 1,88 $ au plancher

La facturation ne porte que sur les requêtes réussies, et l'essai est de 500 crédits sans carte bancaire.

Avantages et inconvénients

Comment l'utiliser

Requête

curl -G 'https://api.piloterr.com/v2/leboncoin/search' \
  -H 'x-api-key: YOUR_API_KEY' \
  --data-urlencode 'query=https://www.leboncoin.fr/recherche?category=9&locations=Paris'
f

Requête

curl -G 'https://api.piloterr.com/v2/leboncoin/ad' \
  -H 'x-api-key: YOUR_API_KEY' \
  --data-urlencode 'query=3227906670'
f

L'endpoint d'annonce accepte soit un simple ID d'annonce, soit une URL complète. Les deux marchent.

Un attribut dans la réponse ressemble à ça, et les libellés français sont le vrai avantage.

Réponse

{
  "key": "type_real_estate_sale",
  "value": "ancien",
  "value_label": "Ancien",
  "key_label": "Type de vente",
  "generic": true
}
f

Est-il légal de scraper Leboncoin ?

Est-ce que Leboncoin l'autorise ? Non.

En fait, le site prend activement des mesures pour l'empêcher... le robots.txt interdit l'accès automatisé, les conditions interdisent d'extraire son contenu, et la protection anti-bot bloque les scripts à vue.

Mais est-ce que ça le rend illégal ? Pas forcément, tant que tu restes dans le RGPD et le droit français et que tu ne bombardes pas le site.

1. Scraper des données non substantielles pour un usage interne est globalement admis
2. Republier ou distribuer commercialement les données de Leboncoin est hors limites... un scraper a été condamné à 50 000 € dans l'affaire Entreparticuliers c. Leboncoin (2021), et le droit français des bases de données (article L342-3 du Code de la propriété intellectuelle) va dans ce sens
3. Les données personnelles des vendeurs comme les numéros et les e-mails relèvent du RGPD, donc il te faut une base légale pour les collecter

FAQ

Leboncoin a-t-il une API officielle ?

Puis-je utiliser l'API auto de Leboncoin pour récupérer les annonces de voitures ?

Non. Elle identifie et cote des véhicules : recherche par plaque, données de carte grise, cote Argus, valeur résiduelle. Elle ne renvoie jamais une annonce, un prix demandé ou un vendeur. Elle n'est pas non plus en self-service, et même un compte de test exige un contrat annuel.

Quelle est la différence entre l'API officielle et une API de scraping ?

Elles répondent à des questions différentes. L'API Argus® cote des véhicules à la plaque, et ne lit jamais la marketplace. Les API de scraping extraient les données publiques des annonces, gèrent la couche anti-bot pour toi, et facturent au résultat réussi.

Pourquoi les scrapers Leboncoin se font-ils bloquer ?

Leboncoin fait tourner une des protections anti-bot les plus strictes de toutes les marketplaces européennes, et elle est activement maintenue. Un simple script ou un navigateur headless par défaut tombe sur un mur de vérification presque immédiatement, et avoir les outils de développement ouverts fait partie des déclencheurs listés par Leboncoin lui-même. Passer au travers implique une dépense continue en proxies résidentiels et une maintenance permanente face à des changements que tu ne contrôles pas.

Existe-t-il une API Leboncoin synchrone ?

Oui, Piloterr. Un seul GET renvoie les données dans la même réponse. lobstr.io est asynchrone : tu crées un Squid, tu le lances, tu interroges, tu récupères. Si un utilisateur attend la réponse, c'est du sync qu'il te faut.

Peut-on récupérer les numéros de téléphone des vendeurs via une API Leboncoin ?

Combien coûte le scraping de Leboncoin à grande échelle ?

Les données d'annonces reviennent à 2 $ les 1 000 sur lobstr.io à grande échelle, ou 3,76 $ les 1 000 sur Piloterr à son plancher publié. Les numéros de téléphone sont exclusifs à lobstr.io, à 5 $ les 1 000, et tu ne paies les crédits téléphone que sur les annonces où un numéro est réellement trouvé. À l'entrée, l'ordre s'inverse, avec Piloterr qui démarre à 5,44 $ contre 8 $ pour lobstr.io.

Comment récupérer les données dans un tableur ou un workflow ?

lobstr.io te les livre. Les résultats s'exportent en CSV, Excel ou JSON, et peuvent être poussés directement vers Google Sheets, S3, SFTP, e-mail ou un webhook sans écrire de boucle de récupération. Piloterr renvoie du JSON dans la réponse HTTP, et tout ce qui vient après, tu le construis.

Combien de temps mes données sont-elles conservées ?

28 jours sur lobstr.io. Zéro sur Piloterr. Piloterr ne stocke rien, donc la réponse est ta seule copie... persiste-la dès réception.

Conclusion

Leboncoin a une API officielle, et elle cotera ta voiture à merveille. Pour tout ce qui touche à la marketplace elle-même, il te faut un tiers.

1. lobstr.io si tu veux de la profondeur et de la durabilité. Six endpoints, la seule source de numéros de téléphone vendeur et de données de réputation, des fiches entreprise B2B avec SIREN et SIRET, une fiabilité publiée, et 2 $ les 1 000 à grande échelle. Tu paies ça en asynchrone, en lenteur par worker, et en absence de palier gratuit
2. Piloterr si tu veux une réponse dans une seule requête. Rapide, peu chère au démarrage, vraiment synchrone, avec les meilleures données géo et image des deux. Tu abandonnes les numéros, la réputation vendeur, et toute rétention de données

Si tu construis un pipeline de monitoring, note que le Status Checker coûte 1 crédit et ne renvoie aucune donnée personnelle. Surveille pour pas cher, enrichis de façon sélective.

Envie de leads Leboncoin avec numéro vérifié, sans passer ton temps à surveiller des logins ? Lance l'export téléphone et fais tourner ton premier Squid.