Une clé, quatre sources, un format JSON. Vous interrogez l'API quand vous en avez besoin, vous payez au crédit ce qui a réellement abouti — pas d'abonnement, pas de serveur à maintenir.
L'API fonctionne à la demande : requête sur l'endpoint de la source voulue, scraping en temps réel, réponse JSON renvoyée directement. Aucune tâche planifiée ni file d'attente à gérer.
Chaque appel est authentifié par un jeton porteur (Bearer) unique à votre compte, généré depuis votre tableau de bord.
Authorization: Bearer <votre_cle_api>
Content-Type: application/jsonVos crédits sont communs à Leboncoin, Vinted, Kleinanzeigen et Marktplaats : vous rechargez une seule fois et répartissez votre consommation selon vos besoins. Détail de la conversion euros → crédits sur la page tarifs.
Chaque source a ses propres plafonds de dépense (jour / mois / max) et sa propre limite de débit, pour éviter toute surconsommation et respecter la capacité de scraping disponible.
| Paramètre | Portée | Où le consulter |
|---|---|---|
| Plafond jour / mois / max | Par source | Dashboard → API |
| Rate limit | Par source | |
| Coût par requête réussie | Par source |
Chaque endpoint prend un paramètre url : configurez votre recherche directement sur le site de la source (Leboncoin, Vinted, Kleinanzeigen ou Marktplaats), copiez l'URL de la page de résultats, et passez-la telle quelle à l'API.
curl -H "Authorization: Bearer TA_CLE_API" \
"https://bot.lebondeal-bot.fr/api/v1/leboncoin/search?url=https%3A%2F%2Fwww.leboncoin.fr%2Frecherche%3Ftext%3Diphone%2B13"import requests
resp = requests.get(
"https://bot.lebondeal-bot.fr/api/v1/leboncoin/search",
headers={"Authorization": "Bearer TA_CLE_API"},
params={"url": "https://www.leboncoin.fr/recherche?text=iphone+13"},
)
data = resp.json()
print(data["count"], "annonce(s) trouvée(s)")Même logique pour /api/v1/vinted/search, /api/v1/kleinanzeigen/search et /api/v1/marktplaats/search — seule l'URL passée en paramètre change.
| Code | Erreur | Signification |
|---|---|---|
400 | invalid_url | Paramètre url manquant ou invalide pour l'API appelée |
401 | unauthorized | Clé API absente, invalide ou révoquée |
402 | insufficient_credits | Solde de crédits insuffisant |
402 | account_paused | Compte en pause (solde ou cap de dépenses global atteint) |
402 | api_limit_reached | Plafond jour/mois/max de cette API atteint |
403 | api_not_activated | Cette API n'est pas encore activée sur le compte |
429 | rate_limited | Trop de requêtes (limite par clé ou par IP dépassée) |
503 | unexpected_error | Incident temporaire persistant malgré plusieurs tentatives internes |
Une recherche techniquement échouée et une recherche légitimement vide renvoient toutes les deux 503, sans distinction possible côté client — mais sans débit de crédit dans les deux cas. Détail complet sur la documentation.
Clé au format lbd_live_..., affichée une seule fois à sa création — en cas de perte, révoquez-la et générez-en une nouvelle. Ne la placez jamais dans du code front-end.
Garde-fous partagés entre toutes les API du compte : 30 requêtes/minute par clé, 180 requêtes/minute par IP. Chaque API a aussi son propre plafond de requêtes/minute. Une requête peut prendre jusqu'à ~40s en cas d'incident temporaire — prévoyez un timeout client d'au moins 45s.
Chaque requête passe par un pool de proxies résidentiels rotatifs, avec relances automatiques en cas d'échec temporaire. Si la requête échoue malgré les relances, aucun crédit n'est débité.
État en temps réel des sources : page statut.
Annonces particuliers et pros, toutes catégories, recherche par mots-clés, prix et zone.
Annonces mode et seconde main, profils vendeurs, filtres marque, taille et état.
Équivalent allemand de Leboncoin. Prix en euros, JSON structuré.
Équivalent néerlandais de Leboncoin. Nouvelle source, prix en euros, JSON structuré.
Une autre source vous manque ? Suggérez-la.
Créez un compte sur le tableau de bord, rechargez des crédits, puis générez votre clé depuis la section API. Utilisable immédiatement dans l'en-tête Authorization: Bearer.
Non. Un crédit n'est débité que lorsque la requête aboutit et renvoie des données.
Chaque endpoint attend une URL de recherche déjà filtrée depuis le site de la source (Leboncoin, Vinted, Kleinanzeigen ou Marktplaats) — configurez vos filtres dans le navigateur, copiez l'URL de résultats, passez-la à l'API.
Oui, un seul solde de crédits couvre Leboncoin, Vinted, Kleinanzeigen et Marktplaats.
Ces valeurs évoluent régulièrement : toujours à jour sur votre tableau de bord API.
Non, l'API fonctionne uniquement au crédit consommé.
Oui, via le formulaire de la page marketplace de sources.
Générez votre clé, rechargez des crédits, lancez votre premier appel en quelques minutes.
LeBonDeal
Bot Discord gratuit pour vos alertes Leboncoin, et API à la demande pour extraire des données Leboncoin, Vinted, Kleinanzeigen et Marktplaats en JSON.
© LeBonDeal — Tous droits réservés.