Rejoindre Discord →
Général
Accueil Bot Leboncoin Cas d'usage Tarifs Contact
API
Vue d'ensemble Leboncoin Vinted Kleinanzeigen Marktplaats Suggérer une source
Ressources
Documentation Guides FAQ Statut
Rejoindre le Discord →
📘 Documentation

Documentation de l'API LeBonDeal

Tout ce qu'il faut pour intégrer l'API : authentification, endpoints par source, pagination, gestion des erreurs et quotas. Réponse directe : chaque endpoint prend une clé Bearer et une URL de recherche déjà filtrée sur le site de la source, et renvoie du JSON.

Obtenir une clé API Voir le hub API

Quickstart — 5 minutes

Trois étapes pour votre premier appel :

  • 1. Créez une clé — depuis votre tableau de bord, section clés API.
  • 2. Activez une source — Leboncoin, Vinted, Kleinanzeigen ou Marktplaats, depuis la marketplace API du dashboard.
  • 3. Construisez votre URL de recherche — configurez vos filtres directement sur le site de la source, copiez l'URL de résultats.
Premier appel
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"
Chaque source dispose de sa propre page produit avec des exemples dédiés : Leboncoin, Vinted, Kleinanzeigen, Marktplaats.

Authentification

Toutes les requêtes doivent inclure votre clé API dans l'en-tête Authorization, au format Bearer.

En-tête HTTP
Authorization: Bearer lbd_live_xxxxxxxxxxxxxxxxxxxxxxxx
Votre clé n'est affichée qu'une seule fois à sa création. En cas de perte, révoquez-la et générez-en une nouvelle depuis le dashboard. Ne la placez jamais dans du code front-end (JS navigateur) — elle serait visible par n'importe qui.

Endpoints par source

Un seul verbe, un seul paramètre : chaque endpoint attend une URL de recherche déjà filtrée sur le site de la source concernée, et renvoie les annonces trouvées sur cette page de résultats.

GET /api/v1/leboncoin/search?url=…

URLs acceptées : pages de résultats leboncoin.fr (/recherche). Détail : page API Leboncoin.

GET /api/v1/vinted/search?url=…

URLs acceptées : pages de résultats vinted.fr (/catalog). Détail : page API Vinted.

GET /api/v1/kleinanzeigen/search?url=…

URLs acceptées : pages de résultats kleinanzeigen.de. Détail : page API Kleinanzeigen.

GET /api/v1/marktplaats/search?url=…

URLs acceptées : /q/… ou /l/… sur marktplaats.nl — pas les fiches annonce (/v/…). Détail : page API Marktplaats.

Réponse type

200 OK
{
  "items": [ { "id": "...", "title": "...", "price": "...", "url": "..." } ],
  "count": 20,
  "total_count": 214,
  "credits_charged": 1,
  "credits_remaining": 9990
}

count est le nombre de résultats renvoyés sur cette page, total_count le nombre total de résultats de la recherche.

Erreurs

CodeErreurSignification
400invalid_urlParamètre url manquant ou invalide pour l'API appelée
401unauthorizedClé API absente, invalide ou révoquée
402insufficient_creditsSolde de crédits insuffisant
402account_pausedCompte en pause (solde ou cap de dépenses global atteint)
402api_limit_reachedPlafond jour/mois/max de cette API atteint
403api_not_activatedCette API n'est pas encore activée sur le compte
429rate_limitedTrop de requêtes (limite par clé ou par IP dépassée)
503unexpected_errorIncident temporaire persistant malgré plusieurs tentatives internes
Une recherche techniquement échouée après plusieurs tentatives internes et une recherche légitimement vide renvoient toutes les deux 503 — impossible de les distinguer côté client. Aucun crédit n'est débité dans les deux cas. Seul 400 invalid_url intervient avant tout scraping.

Quotas & limites

Limites techniques (toutes API)

  • 30 requêtes / minute par clé API — garde-fou partagé entre toutes les API activées sur le compte
  • 180 requêtes / minute par adresse IP
  • Chaque API a en plus son propre plafond de requêtes/minute (ex. 60/60s pour Marktplaats)
  • Une requête peut prendre jusqu'à ~40 secondes en cas d'incident temporaire (tentatives automatiques avant réponse) — prévoyez un timeout client d'au moins 45 secondes

Plafonds de dépense (par source)

Indépendamment des limites techniques, chaque source a ses propres plafonds configurables (jour / mois / maximum), réglables depuis le tableau de bord. Coût par requête, prix d'activation et plafonds actuels : tableau de bord API.