Pour extraire des données structurées depuis Leboncoin, Vinted ou Kleinanzeigen sans gérer l'infrastructure de parsing HTML, vous devez utiliser une API dédiée qui retourne du JSON via un endpoint GET. Cette approche standardise le formatage des prix et localisations, éliminant les variations structurelles propres aux pages web source.

Sommaire
L’architecture des API LeBonDeal repose sur un point d’accès unique, simplifiant la configuration initiale. Vous n’avez pas besoin de gérer plusieurs hôtes ou protocoles selon la marketplace cible (Leboncoin, Vinted, Kleinanzeigen ou Marktplaats). Tous les appels HTTP doivent être dirigés vers l’URL de base fournie dans votre tableau de bord. La structure des endpoints suit une convention stricte : /api/v1/<source>/.... Cette uniformisation réduit la complexité d’intégration et permet de centraliser la gestion réseau.
L’authentification est gérée via un en-tête HTTP standard, sans flux OAuth complexe ni échange de tokens intermédiaires. Vous devez inclure le champ Authorization dans chaque requête GET. Le format attendu est Bearer <clé>, où <clé> correspond à votre identifiant unique généré lors de la création du compte. Cette clé se trouve sur la page « Clés API » de l’espace client. Elle n’est affichée qu’une seule fois au moment de sa génération. En cas d’oubli ou de suspicion de compromission, vous devez révoquer la clé actuelle et en créer une nouvelle directement depuis le tableau de bord.
Pour sécuriser l’accès, vérifiez systématiquement la présence de cet en-tête avant d’envoyer la requête. Une absence ou une invalidité du token entraînera un code HTTP 401 (unauthorized). La même clé et le même solde sont partagés entre toutes les API activées sur votre compte. Consultez la documentation pour connaître la procédure d’activation spécifique de chaque source avant d’émettre vos premières requêtes.
L'architecture unifiée repose sur le paramètre url, copié directement depuis la barre d'adresse du navigateur après application des filtres. Cette contrainte technique implique que l'API ne reconstruit pas de requêtes complexes mais extrait les données brutes correspondant à la vue actuelle. Le tableau ci-dessous compare les spécificités structurelles et sémantiques par source.
price sont des chaînes pour Kleinanzeigen, Marktplaats et Vinted (ex: "120 €"), mais un nombre entier pour Leboncoin (280). La conversion doit être gérée dynamiquement.| Critère | Leboncoin | Vinted | Kleinanzeigen | Marktplaats |
|---|---|---|---|---|
| Endpoint | /api/v1/leboncoin/search | /api/v1/vinted/search | /api/v1/kleinanzeigen/search | /api/v1/marktplaats/search |
| Paramètre clé | url + page (optionnel) | url uniquement (1ère page) | url uniquement (1ère page) | url uniquement (1ère page) |
Type de price | Nombre entier | Chaîne avec devise | Chaîne avec devise | Chaîne avec devise (EUR) |
| Description complète | Nécessite l'endpoint /ad par url | Non disponible dans la liste | Non disponible dans la liste | Incluse directement (description) |
| Métadonnées vendeur | owner.user_id, name, type | Aucune donnée vendeur directe | Aucune donnée vendeur directe | seller_name, seller_verified (bool) |
| Date de publication | Chaîne ISO (YYYY-MM-DD HH:MM:SS) | Aucun champ date explicite | Chaîne locale non parsable (ex: "Heute, 09:14") | Chaîne locale néerlandaise (ex: "Vandaag...") |
| Total résultats | count (page courante) | count (page courante) | count (page courante) | total_count + count |
L'analyse technique révèle une hétérogénéité des formats de réponse. Pour Leboncoin, la pagination est gérée via le paramètre page, tandis que les autres sources (Vinted, Kleinanzeigen, Marktplaats) ne retournent systématiquement que la première page de résultats. La gestion du prix nécessite une adaptation stricte : seule l'API Leboncoin renvoie un type numérique natif, contrairement aux chaînes formatées des concurrents qui exigitent un parsing dédié avant tout calcul arithmétique. De même, le champ published sur Kleinanzeigen et Marktplaats est non structuré (texte local) et ne peut être converti en ISO sans traitement externe spécifique. Enfin, la description complète n'est accessible que via l'endpoint /ad de Leboncoin ou nativement pour Marktplaats, imposant une stratégie d'appels supplémentaires si le contenu détaillé est requis dès la phase de filtrage initial. Pour plus de détails sur les spécificités de chaque source, consultez la documentation API.
L'intégration multi-sources nécessite un traitement asynchrone ou séquentiel rigoureux des réponses, en respectant les spécificités de chaque marketplace. Le script ci-dessous illustre l'appel concurrent vers Leboncoin et Kleinanzeigen, avec une gestion explicite des timeouts longs (45 s) imposés par le serveur lors d'incidents temporaires.
import os
import requests
from datetime import datetime
BASE_URL = os.environ.get("LEBONDEAL_BASE_URL", "https://bot.lebondeal-bot.fr")
API_KEY = os.environ["LEBONDEAL_API_KEY"]
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
def fetch_marketplace(endpoint, url):
try:
response = requests.get(f"{BASE_URL}{endpoint}", params={"url": url},
headers=HEADERS, timeout=45)
if response.status_code == 200:
data = response.json()
count = data.get("count", 0) or len(data.get("ads") or data.get("items", []))
print(f"[{endpoint}] {count} résultats. Crédits restants : {data['credits_remaining']}")
elif response.status_code == 429:
# Limite de débit atteinte ; attendre et réessayer avec délai croissant
print("Rate limited (429). Attente...")
return None
elif response.status_code == 503:
# Erreur serveur ou recherche vide/échouée non facturée
print(f"Erreur {endpoint} : {response.json().get('message')}")
except requests.exceptions.Timeout:
print("Timeout >45s sur l'API.")
# Exemple d'appel simultané (séquentiel ici pour la clarté)
url_lb = "https://www.leboncoin.fr/recherche?category=0&text=laptop"
url_kz = "https://www.kleinanzeigen.de/s-laptop/anzeige/kleinanzeigen"
# Endpoint Leboncoin : /api/v1/leboncoin/search (retourne 'ads')
fetch_marketplace("/api/v1/leboncoin/search", url_lb)
# Endpoint Kleinanzeigen : /api/v1/kleinanzeigen/search (retourne 'items')
fetch_marketplace("/api/v1/kleinanzeigen/search", url_kz)Ce code démontre l'uniformité de l'authentification via l'en-tête Authorization, tout en gérant les différences structurelles des réponses (ads vs items). La gestion du timeout à 45 secondes est cruciale car le serveur peut effectuer des tentatives silencieuses avant de renvoyer une erreur définitive. Pour vérifier la compatibilité des endpoints spécifiques, consultez la documentation Leboncoin ou Kleinanzeigen.
Les codes d'erreur HTTP 4xx signalent des problèmes liés à la configuration de votre requête ou à l'état de votre compte. Ils nécessitent une intervention immédiate côté client avant toute nouvelle tentative, car le serveur ne traitera pas la demande tant que l'anomalie n'est pas corrigée.
Le code 401 Unauthorized indique que la clé d'authentification est absente, invalide ou a été révoquée. Vérifiez l'en-tête Authorization et assurez-vous qu'il contient bien votre token Bearer valide. Si vous avez perdu votre clé, générez-en une nouvelle depuis le tableau de bord ; elle ne s'affiche qu'une seule fois lors de la création.
Le code 400 invalid_url se produit lorsque l'URL fournie est manquante ou inadaptée à l'endpoint concerné (par exemple, utiliser un lien vers une fiche annonce plutôt que les résultats de recherche). Chaque marketplace impose des formats d'URL spécifiques ; consultez la documentation technique pour vérifier le format attendu.
Les codes 402 gèrent les restrictions liées au compte :
insufficient_credits : votre solde est insuffisant pour payer la requête.account_paused : votre compte est suspendu en raison d'un plafond de dépenses atteint ou d'une absence de rechargement.api_limit_reached : vous avez dépassé les limites spécifiques à cette API (quotas jour/mois).Le code 429 rate_limited signifie que vous envoyez trop de requêtes simultanément ou dans un laps de temps donné. Il est recommandé d'implémenter une logique de back-off exponentiel plutôt qu'un simple retry immédiat pour éviter d'alourdir la charge du serveur et votre propre consommation CPU.
Accédez aux spécifications techniques complètes et testez les endpoints directement depuis votre tableau de bord.
Découvrir l'API LeBonDealLire la documentationLe scraping automatisé impose de gérer la variabilité inhérente aux infrastructures cibles. Vous ne contrôlez pas le temps de réponse des marketplaces (Leboncoin, Vinted, Kleinanzeigen ou Marktplaats). En cas d'incident temporaire côté serveur, les mécanismes internes peuvent prolonger l'exécution avant un retour définitif. Une requête peut ainsi s'étendre jusqu'à environ 40 secondes. Il est impératif de configurer votre client HTTP avec un timeout supérieur à cette durée pour éviter des interruptions prématurées du traitement. Un délai de 45 secondes constitue une marge de sécurité minimale recommandée.
La gestion des erreurs repose sur les codes standards HTTP et le corps JSON retourné. Une erreur 401 unauthorized indique que votre clé API est invalide ou absente ; dans ce cas, régénérez-la depuis le tableau de bord car elle ne peut être récupérée une fois perdue. Les erreurs 5xx, notamment la 503 unexpected_error, signalent un échec technique persistant après les tentatives automatiques internes. Contrairement à d'autres services, vous ne pouvez pas distinguer une recherche techniquement échouée d'une recherche légitimement vide : dans les deux cas, aucun crédit n'est débité et le statut 503 est renvoyé.
YOUR_API_KEY dans du code front-end ou JavaScript navigateur. Elle serait alors visible publiquement et compromettreait l'accès à vos crédits.Pour les plafonds de dépenses, les quotas par API et la tarification actuelle, consultez directement nos tarifs.
Quel format de date retourne l'API Kleinanzeigen ?
L'API renvoie la date sous forme d'une chaîne en allemand, par exemple "Heute, 09:14". Ce format n'est pas au standard ISO et nécessite un traitement spécifique pour être interprété.
Peut-on paginer les résultats Vinted via l'API ?
Non, il est impossible de paginer les résultats sur cette source. L'endpoint retourne systématiquement uniquement la première page des annonces sans paramètre disponible pour accéder aux suivantes.
Comment récupérer la description complète d'une annonce Leboncoin ?
La liste retournée par l'endpoint de recherche ne contient pas le corps du texte. Vous devez appeler l'endpoint dédié à la fiche individuelle en utilisant l'url ou l'id de l'annonce pour obtenir la description intégrale.
Quelle est la différence entre un échec technique et une recherche vide ?
Ces deux cas renvoient tous les deux un code d'état 503 sans facturation des crédits. Il n'est pas possible de distinguer côté client si l'échec provient du site cible ou d'un incident temporaire.
Où trouver le user_id pour interroger un profil vendeur ?
L'identifiant se trouve dans la réponse JSON, spécifiquement dans le champ owner.user_id. Il est accessible après une requête sur l'endpoint de recherche ou sur celui d'une annonce individuelle.
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.