Rejoindre le Discord →
16 novembre 2026 8 min de lecture API Scraping

Comparatif des API de scraping marketplaces disponibles en France

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.

Illustration technique montrant des requêtes HTTP sécurisées connectées à une base de données cloud pour le scraping
Bearer
Authentification par clé
GET
Méthode HTTP requise
JSON
Format de réponse standardisé

Architecture et Authentification Unifiée

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.

En pratique : Ne stockez jamais cette clé dans du code front-end (JavaScript navigateur). Elle serait exposée publiquement et pourrait être utilisée par des tiers pour consommer vos crédits sans votre autorisation.

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.

Comparaison des Endpoints par Marketplace

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.

En pratique : Les champs 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èreLeboncoinVintedKleinanzeigenMarktplaats
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 priceNombre entierChaîne avec deviseChaîne avec deviseChaîne avec devise (EUR)
Description complèteNécessite l'endpoint /ad par urlNon disponible dans la listeNon disponible dans la listeIncluse directement (description)
Métadonnées vendeurowner.user_id, name, typeAucune donnée vendeur directeAucune donnée vendeur directeseller_name, seller_verified (bool)
Date de publicationChaîne ISO (YYYY-MM-DD HH:MM:SS)Aucun champ date expliciteChaîne locale non parsable (ex: "Heute, 09:14")Chaîne locale néerlandaise (ex: "Vandaag...")
Total résultatscount (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.

Intégration Python : Script Multi-Sources

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.

En pratique : Notez que les prix et dates sont souvent des chaînes formatées (ex. "120 €" ou "Heute, 09:14") ; vous devrez implémenter un parsing spécifique par source avant toute analyse de données.

Gestion des Erreurs et Retours Techniques

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.

En pratique : Les erreurs 4xx sont toujours factuelles et non facturées en crédits, sauf si elles surviennent après un traitement partiel (rare). Priorisez leur résolution avant de surveiller les incidents serveurs.

Consulter la documentation API

Accédez aux spécifications techniques complètes et testez les endpoints directement depuis votre tableau de bord.

Découvrir l'API LeBonDealLire la documentation

Limitations et Bonnes Pratiques

Le 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é.

En pratique : Ne jamais exposer votre clé API 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.

FAQ

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.

Articles liés