L'API LeBonDeal convient aux développeurs nécessitant un contrôle précis sur les requêtes GET afin d'intégrer des données dans leurs systèmes, tandis que le bot Discord est conçu pour recevoir des notifications simples sans code. Ce choix dépend de votre capacité technique et de la fréquence de vos besoins d'extraction.

Sommaire
L’architecture de l’API LeBonDeal repose sur un modèle client-serveur standard. Vous envoyez des requêtes HTTP GET vers les endpoints documentés, en fournissant votre clé d’authentification via le header Authorization. Le serveur traite la demande, interroge la source cible (Leboncoin, Vinted ou Kleinanzeigen) et renvoie une réponse JSON structurée contenant uniquement les données correspondant à vos filtres. Ce modèle est asynchrone : vous contrôlez entièrement le moment, la fréquence et l’interprétation des résultats via votre propre code. Vous n’êtes pas lié par un format de sortie prédéfini ou une logique d’alerte rigide.
En revanche, un bot Discord fonctionne comme un intermédiaire passif-actif. Il maintient une connexion permanente au serveur pour surveiller les changements en temps réel selon des règles statiques configurées à l’avance. Vous ne récupérez pas le flux brut de données ; vous recevez des notifications push lorsque ces règles sont satisfaites. Cette architecture simplifie la mise en place pour un usage ponctuel (une alerte par item), mais réduit votre contrôle sur le traitement des données : vous devez gérer les webhooks ou les messages Discord, ce qui introduit une dépendance à la plateforme de messagerie et à sa propre latence.
L’API LeBonDeal s’impose lorsque votre architecture nécessite un traitement automatisé des données extraites. Contrairement à une simple notification, l’accès direct aux endpoints vous permet d’intégrer les résultats dans vos bases de données internes, vos dashboards analytiques ou vos workflows ETL. Cette approche est indispensable pour croiser des informations provenant de multiples sources (Leboncoin, Vinted, Kleinanzeigen) et appliquer des filtres complexes côté client avant la prise de décision.
Vous devez opter pour cette solution si :
À l’inverse, si votre besoin se limite à recevoir une notification dès qu’un critère spécifique apparaît sur le marché, un système de monitoring léger est plus adapté. Il évite la complexité d’une intégration technique pour un usage ponctuel ou opérationnel immédiat sans traitement ultérieur. La décision repose donc sur la nature du flux : donnée brute traitée en temps réel contre signal déclencheur.
| Critère technique | API LeBonDeal | Bot Discord (LeBonDeal) |
|---|---|---|
| Gestion de l'authentification | Nécessite le header Authorization: Bearer <clé>. La clé doit être sécurisée (variables d'environnement). | Aucune gestion directe. L'accès se fait via les permissions du serveur Discord. |
| Traitement des erreurs | L'utilisateur doit analyser le JSON de réponse pour détecter 401 unauthorized, 429 rate_limited ou 503 unexpected_error et implémenter la logique de retry. | Abstrait. Le bot notifie l'échec silencieux ou les changements d'état sans exposer le code erreur HTTP au développeur final. |
| Flexibilité des requêtes | Pleine maîtrise du timing, de la fréquence et des filtres via l'URL copiée. Permet le scraping à la demande (on-demand). | Réduit aux paramètres configurables dans les commandes /alerte ou /search. Moins adapté au flux continu. |
| Détention des données | L'API retourne le JSON brut que vous stockez où vous voulez (base de données, data lake). | Les alertes sont éphémères. Aucune persistance native n'est fournie par le bot lui-même. |
L'API impose une charge opérationnelle significative : vous devez gérer la rotation des clés, le back-off exponentiel en cas de 429 rate_limited, et les timeouts potentiels allant jusqu'à 45 secondes pour les requêtes stables. Contrairement au bot Discord qui agit comme un canal de notification passive, l'API est un outil actif nécessitant une intégration robuste côté client. Pour comprendre les spécificités des endpoints Leboncoin ou Vinted, consultez la documentation technique.
Le script Python ci-dessous illustre l'appel standard à l'API LeBonDeal. Il utilise requests pour gérer la requête HTTP, respecte les contraintes de timeout et traite les codes d'erreur spécifiques au service.
import os
import time
import requests
BASE_URL = os.environ.get("LEBONDEAL_BASE_URL", "https://bot.lebondeal-bot.fr")
API_KEY = os.environ["LEBONDEAL_API_KEY"]
TARGET_SOURCE = "leboncoin" # ou vinted, kleinanzeigen
SEARCH_URL = "https://www.leboncoin.fr/recherche?category=3"
def fetch_listings():
headers = {"Authorization": f"Bearer {API_KEY}"}
while True:
response = requests.get(
url=f"{BASE_URL}/api/v1/{TARGET_SOURCE}",
params={"url": SEARCH_URL},
headers=headers,
timeout=45 # Timeout élevé pour les incidents internes
)
if response.status_code == 200:
data = response.json()
print(f"Crédits restants : {data['credits_remaining']}")
return data.get('results', [])
elif response.status_code == 429:
# Rate limiting : attendre avant de réessayer
time.sleep(5)
elif response.status_code in (401, 403):
raise Exception("Clé invalide ou API désactivée")
elif response.status_code == 402:
raise Exception("Solde insuffisant ou compte en pause")
elif response.status_code == 503:
# Erreur technique persistante ou recherche vide sans résultat
print("Erreur serveur ou aucun résultat trouvé.")
return []
else:
error_msg = response.json().get('message', 'Inconnu')
raise Exception(f"Erreur {response.status_code} : {error_msg}")
if __name__ == "__main__":
results = fetch_listings()Ce code met en œuvre une boucle de retry simple pour gérer le rate limiting (429) et les erreurs serveur temporaires (503). Il exploite exclusivement les champs credits_remaining et results retournés par l'API. Pour adapter la source, modifiez simplement le nom dans le chemin <a href="https://lebondeal-bot.fr/api/vinted/">Vinted</a> ou /kleinanzeigen/. Le timeout de 45 secondes est obligatoire car les tentatives silencieuses côté serveur peuvent augmenter la latence.
Consultez la documentation pour comprendre le fonctionnement des endpoints et gérez vos crédits depuis votre tableau de bord.
Découvrir l'API LeBonDealLire la documentationLe bot Discord LeBonDeal s'impose comme la solution pertinente lorsque votre priorité n'est pas l'exploitation technique des données, mais leur acquisition immédiate dans un flux de travail existant. Contrairement à une API qui exige la construction d'un pipeline d'intégration (authentification, gestion des erreurs 429/503, parsing JSON), le bot opère en mode passif : vous configurez les filtres via l'interface web et recevez les alertes directement sur votre canal Discord.
Cette approche convient aux revendeurs ou particuliers qui privilégient la réactivité à la granularité des données. Vous ne souhaitez pas gérer un serveur Node.js ou Python pour surveiller quelques annonces critiques. Le bot abstrait la complexité du scraping : il gère les timeouts, les changements de structure DOM et l'envoi push sans intervention manuelle.
Choisissez cette option si :
L'API LeBonDeal envoie-t-elle des webhooks HTTP ?
Non, le service ne propose pas de fonctionnalité webhook. Vous devez implémenter votre propre logique d'appel périodique (polling) pour récupérer les données.
Puis-je utiliser la même clé API pour plusieurs sources ?
Oui, une seule clé et un solde unique sont utilisés pour toutes les APIs disponibles sur le compte. La gestion des accès se fait via le tableau de bord.
Comment gérer les erreurs 429 rate limited sur l'API ?
En cas d'erreur 429, attendez quelques secondes puis réessayez avec un délai croissant (backoff exponentiel). Ne vous fiez à aucun en-tête HTTP spécifique pour le délai.
Le bot Discord peut-il filtrer par prix maximum ?
Cette question concerne l'outil LeBonDeal Bot, qui n'est pas couvert dans cet article technique dédié aux APIs. Consultez la documentation du bot pour ses fonctionnalités de notification.
LeBonDealBot Discord gratuit pour vos alertes Leboncoin, et API à la demande pour extraire des données Leboncoin, Vinted, Kleinanzeigen et Marktplaats en JSON.
© 2026 LeBonDeal — Tous droits réservés.