Un outil de veille concurrentielle sur Leboncoin, Vinted et Kleinanzeigen nécessite d'interroger les endpoints `/search` spécifiques à chaque source via l'API LeBonDeal. Ce script Python centralise la récupération des données pour comparer les prix en temps réel sans gérer le scraping direct.
Sommaire
Pour mettre en place une veille concurrentielle fiable sur plusieurs marketplaces, l'architecture recommandée repose sur la centralisation des requêtes via un point d'entrée unique. Plutôt que de développer et maintenir des scrapers HTML spécifiques pour Leboncoin, Vinted ou Kleinanzeigen, vous utilisez les endpoints dédiés fournis par l'API. Cette approche élimine la fragilité liée aux changements structurels du DOM des sites cibles.
Le principe technique est simple : chaque marketplace expose un endpoint GET sous /api/v1/<source>/search. Vous ne devez pas recréer les filtres de recherche côté client. À la place, configurez vos critères (catégorie, localisation, prix) directement dans l'URL du navigateur sur le site source, puis transmettez cette URL brute au paramètre url de votre requête API. Le serveur se charge de l'extraction et de la normalisation des données avant réponse.
L'avantage majeur réside dans l'unification de l'authentification et de la facturation :
Authorization: Bearer <clé>) suffit pour accéder à toutes les sources.count, credits_charged et credits_remaining.La sécurisation des identifiants et la configuration initiale sont critiques pour éviter toute fuite de clé API ou interruption de service prématurée. Vous devez stocker LEBONDEAL_API_KEY dans une variable d'environnement protégée, jamais en dur dans le code source. L'URL de base est définie par défaut à https://bot.lebondeal-bot.fr.
Le script suivant illustre la structure de base, en utilisant uniquement des champs documentés dans la documentation API. Il gère explicitement les codes d'erreur 429 et 503.
import os
import requests
BASE_URL = os.environ.get("LEBONDEAL_BASE_URL", "https://bot.lebondeal-bot.fr")
API_KEY = os.environ["LEBONDEAL_API_KEY"]
def fetch_data(endpoint, url):
headers = {"Authorization": f"Bearer {API_KEY}"}
try:
response = requests.get(
f"{BASE_URL}{endpoint}",
params={"url": url},
headers=headers,
timeout=45
)
if response.status_code == 429:
print("Rate limited. Réessayer plus tard.")
return None
if response.status_code == 503:
print("Erreur serveur ou recherche vide (non facturée).")
return None
data = response.json()
credits_remaining = data.get("credits_remaining", "N/A")
count = data.get("count", 0)
if endpoint.startswith("/api/v1/leboncoin"):
ads = data.get("ads", [])
else:
ads = data.get("items", [])
print(f"Crédits restants : {credits_remaining} | Résultats trouvés : {count}")
return ads
except requests.exceptions.RequestException as e:
print(f"Erreur réseau : {e}")
return None
# Exemple d'appel pour Leboncoin (voir /api/leboncoin/)
fetch_data("/api/v1/leboncoin/search", "https://www.leboncoin.fr/recherche?category=0")
Ce code initialise la connexion avec les en-têtes requis et extrait uniquement count et credits_remaining. Il différencie les champs de réponse selon l'endpoint (ads pour Leboncoin, items pour Vinted/Kleinanzeigen).
La normalisation des prix est l'étape critique de votre pipeline de veille, car les sources ne partagent pas le même format de réponse. Vous devez traiter chaque API séparément avant toute comparaison croisée.
Pour Leboncoin, la valeur brute est un nombre flottant ou entier dans le champ price. Elle est directement exploitable pour des calculs arithmétiques sans étape intermédiaire. En revanche, Vinted et Kleinanzeigen renvoient une chaîne de caractères incluant la devise (ex. "15.0 EUR" ou "120 €").
Cette différence structurelle impose deux stratégies distinctes :
price. Vérifiez systématiquement l'absence de ce champ si une annonce est mal formatée côté source, car cela peut entraîner des erreurs de type lors des calculs.re.search(r'\d+\.?\d*', item['price']). Convertissez ensuite explicitement cette chaîne en float.Pour garantir la cohérence des données, il est recommandé de standardiser toutes les valeurs dans votre base locale au format ISO 4217 avec deux décimales. Cela simplifie les requêtes SQL ultérieures et évite les erreurs d'arrondi lors du tri par ordre croissant ou décroissant. L'utilisation systématique de la fonction Decimal en Python est préférable à float pour éviter les imprécisions binaires sur des montants financiers précis, surtout si vous effectuez des agrégations volumineuses.
Pour comprendre comment récupérer ces données brutes, consultez la documentation spécifique de l'API Leboncoin et celle de Vinted.
Une fois les prix normalisés en euros, il est possible d’identifier les écarts tarifaires et les opportunités de revente entre les plateformes. La comparaison croisée repose sur l’agrégation des données extraites via nos endpoints respectifs : LeBonDeal API Leboncoin, Vinted et Kleinanzeigen.
| Critère | Leboncoin (FR) | Vinted (EU) | Kleinanzeigen (DE) |
|---|---|---|---|
| Format du prix | Nombre entier/flottant (ex : 280) |
Chaîne avec devise (ex : "15.0 EUR") |
Chaîne locale (ex : "120 €") |
| Parsing requis | Aucun (cast direct float/int) | Obligatoire (split EUR/,) |
Obligatoire (nettoyage espace/devise) |
| Gestion des absences | Filtrer si price est null/N/A |
Filtrer si chaîne vide ou invalide | Filtrer si champ HTML manquant |
Pour automatiser cette veille, vous devez d’abord standardiser les valeurs monétaires. Sur Vinted et Kleinanzeigen, le prix est une chaîne de caractères contenant la devise ; sur Leboncoin, c’est un type numérique brut. Utilisez une fonction utilitaire pour convertir chaque entrée en un float unique (EUR) avant tout calcul. Ensuite, effectuez une jointure par référence produit ou par similarité sémantique si l’ID n’est pas disponible.
L’analyse doit intégrer le statut de l’article (status chez Vinted) ou la localisation (location) pour filtrer les annonces hors zone géographique cible. Les opportunités se situent souvent sur les écarts supérieurs à 15-20 % entre une plateforme B2C (Vinted/Kleinanzeigen) et le marché de l’occasion directe (Leboncoin), après déduction des frais de transaction potentiels.
Consultez les tarifs et documentations techniques disponibles directement sur notre site.
Découvrir l'API LeBonDealLire la documentationLes requêtes vers une marketplace ne sont pas toujours instantanées. En cas d’incident technique côté serveur, le client peut attendre jusqu’à 40 secondes avant de recevoir la réponse finale. Il est impératif de configurer un timeout client d’au moins 45 secondes pour éviter les interruptions prématurées.
La distinction entre une recherche vide et un échec technique repose sur le code HTTP retourné. Une erreur 503 indique soit une absence totale de résultats, soit un incident persistant malgré les tentatives internes automatiques. Dans ces deux cas, aucun crédit n’est débité (credits_charged vaut 0). Le client ne peut pas distinguer la cause exacte ; il doit simplement réessayer plus tard sans pénalité financière immédiate.
Pour les erreurs de contrôle ou de quota, le traitement diffère :
Une gestion rigoureuse des codes d’état permet d’éviter la consommation inutile de crédits et assure la stabilité de vos scripts de veille concurrentielle multi-marketplaces.
Comment comparer les prix entre Leboncoin et Kleinanzeigen via l'API ?
Vous devez récupérer la liste des annonces sur chaque marketplace en passant une URL de recherche configurée dans le navigateur à chacun des endpoints respectifs. Les données retournées incluent un identifiant unique, un titre et un champ price que vous pouvez normaliser pour effectuer votre comparaison.
Peut-on extraire des données Vinted sans être bloqué par le CAPTCHA ?
L'API LeBonDeal gère la résolution du CAPTCHA côté serveur, ce qui permet à votre requête de retourner les résultats ou une erreur 503 en cas d'échec technique. Vous n'avez donc pas besoin de gérer cette logique complexe dans votre code client.
Quel est le format de retour du champ price sur chaque marketplace ?
Sur Leboncoin, le prix est renvoyé sous forme d'un nombre entier. Sur Vinted et Kleinanzeigen, il s'agit d'une chaîne incluant la devise (ex : "15.0 EUR" ou "120 €") qu'il convient de parser avant tout calcul.
Combien coûte l'utilisation de cette API pour la veille concurrentielle ?
Les tarifs et les plafonds évoluent régulièrement ; consultez la page des tarifs sur le site officiel pour connaître les coûts actuels par requête. Vous pouvez également vérifier vos crédits restants directement dans votre tableau de bord après chaque appel.
LeBonDeal
Bot 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.