Interrogez Leboncoin par mots-clés, catégorie, prix ou zone géographique, et recevez des annonces prêtes à l'emploi : titre, prix, description, localisation, vendeur, photos.
Pas de query ou de zipcode séparés : configurez vos filtres directement sur leboncoin.fr (mots-clés, catégorie, prix, zone…), copiez l'URL de la page de résultats depuis votre navigateur, et passez-la telle quelle à l'API.
GET /api/v1/leboncoin/search
?url=<url_de_recherche_leboncoin.fr>
Authorization: Bearer <votre_cle_api>Extrait des champs disponibles. Liste complète dans la documentation technique.
| Champ | Type | Description |
|---|---|---|
id | string | Identifiant unique de l'annonce |
title | string | Titre de l'annonce |
description | string | Texte complet de l'annonce |
price | string | Prix formaté avec devise, ex. "380.00 EUR" |
category | string | Catégorie Leboncoin |
city | string | Ville de l'annonce |
seller_name | string | Nom affiché du vendeur (particulier ou pro) |
photos | array | URLs des photos |
url | string | Lien direct vers l'annonce |
La réponse inclut aussi count, total_count, credits_charged et credits_remaining.
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"{
"items": [
{
"id": "2891xxxxx",
"title": "iPhone 13 128Go",
"price": "380.00 EUR",
"city": "Paris",
"seller_name": "Julien",
"url": "https://www.leboncoin.fr/..."
}
],
"count": 1,
"total_count": 47,
"credits_charged": 1,
"credits_remaining": 9990
}| Code | Erreur | Signification |
|---|---|---|
400 | invalid_url | Le paramètre url est manquant ou invalide pour cette API |
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 | API non 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 |
503 — impossible de les distinguer côté client, mais aucun crédit n'est débité dans les deux cas.En plus d'un plafond de requêtes/minute propre à cette API, deux garde-fous s'appliquent à toutes les API du compte : 30 requêtes/minute par clé API, et 180 requêtes/minute par adresse IP. Une requête peut prendre jusqu'à ~40 secondes en cas d'incident temporaire — prévoyez un timeout client d'au moins 45 secondes.
Suivre l'évolution des prix d'une catégorie pour ajuster ses propres tarifs.
Identifier automatiquement les annonces sous-évaluées à racheter et revendre.
Analyser l'offre disponible sur une zone ou une catégorie donnée.
Exemples détaillés : revente, veille concurrence.
Oui : toute recherche configurée sur leboncoin.fr (mots-clés, catégorie, prix, zone) peut être passée à l'API via son URL de résultats.
Non, seules les pages de résultats de recherche sont acceptées, pas les fiches annonce individuelles.
Une recherche vide et un échec technique renvoient tous les deux une erreur 503, sans distinction possible côté client — et sans débit de crédit dans les deux cas.
Seules les informations publiques (nom affiché, type particulier/pro) sont renvoyées.
LeBonDealBot 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.