Rejoindre le Discord →
23 octobre 2026 7 min de lecture API Scraping

API de scraping pour le dropshipping seconde main : par où commencer

Pour structurer votre business de revente, utilisez l’endpoint `/search` de LeBoncoin ou Kleinanzeigen via l'API LeBonDeal afin d'extraire les annonces récentes et suivre les prix. Cette approche technique remplace la veille manuelle par des flux de données fiables directement exploitables dans vos scripts.

Interface de recherche Leboncoin avec filtres activés pour identifier des opportunités d'achat en seconde main.
3
marketplaces supportées
Bearer Token
authentification standard
<45s
timeout recommandé

Sélectionner les sources de données pertinentes

Le dropshipping seconde main, ou plus précisément l'arbitrage en ligne, repose sur la détection de disparités tarifaires entre les marketplaces. Pour être rentable, votre système doit monitorer plusieurs sources simultanément : Leboncoin pour le marché national français, Vinted pour le textile et Kleinanzeigen pour les opportunités transfrontalières allemandes.

Chaque plateforme présente une structure différente qui complexifie l'intégration technique directe. Plutôt que de maintenir des scrapers individuels fragiles face aux mises à jour CSS ou aux anti-bots de chaque site, il est plus robuste d'utiliser un point d'entrée unique. L'API LeBonDeal centralise l'accès à ces trois sources majeures via une seule interface RESTful standardisée.

Cette approche réduit la dette technique et permet de se concentrer sur la logique métier (calcul des marges, gestion des stocks) plutôt que sur la résolution d'erreurs de parsing HTML. Vous configurez vos filtres directement dans l'URL copiée depuis le navigateur du site cible, sans avoir à reconstruire les paramètres de requête spécifiques à chaque API.

En pratique : Assurez-vous que vos URLs sources correspondent bien aux pages de résultats et non aux fiches annonces individuelles pour garantir la pertinence des données retournées.

Configurer l'authentification et les requêtes

Pour interagir avec les endpoints de scraping, vous devez fournir votre clé API via l’en-tête HTTP standard d’authentification Bearer. Cette clé se trouve dans la section « Clés API » de votre tableau de bord ; notez qu’elle n’est affichée qu’une seule fois lors de sa création. En cas de perte ou de compromission potentielle, vous devez révoquer immédiatement l’ancienne clé et en générer une nouvelle. Ne stockez jamais cette valeur dans du code front-end visible par les navigateurs web.

Chaque requête GET nécessite également le paramètre url obligatoire. Il correspond à la chaîne de recherche complète copiée directement depuis la barre d’adresse de votre navigateur après avoir configuré vos filtres (catégorie, localisation, tri). L’API ne permet pas de recréer ces critères via des paramètres séparés ; elle interprète l’URL telle quelle pour extraire les résultats.

En pratique : Assurez-vous que votre client HTTP respecte un timeout d’au moins 45 secondes, car une requête peut prendre jusqu’à 40 secondes en cas de réessais silencieux côté serveur.

Consultez la documentation technique pour les spécificités par source.

Exemple d'intégration Python pour le sourcing

Le traitement des données extraites nécessite une validation stricte des types retournés par l'API, car le format du prix varie selon la source. Pour Leboncoin, price est un entier ou un float direct, tandis que pour Kleinanzeigen, Marktplaats et Vinted, il s'agit d'une chaîne incluant la devise (ex: "120 €"). Cette différence impose une étape de nettoyage avant tout calcul financier.

import os
import time
import requests

BASE_URL = os.environ.get("LEBONDEAL_BASE_URL", "https://bot.lebondeal-bot.fr")
API_KEY = os.environ["LEFBOONDEAL_API_KEY"]  # Clé sécurisée en environnement

SEARCH_URL = "https://www.leboncoin.fr/recherche?category=3&text=vtt"
ENDPOINT = "/api/v1/leboncoin/search"

headers = {"Authorization": f"Bearer {API_KEY}"}
params = {"url": SEARCH_URL, "page": 1}

try:
    response = requests.get(
        f"{BASE_URL}{ENDPOINT}", 
        headers=headers, 
        params=params, 
        timeout=45
    )
    
    if response.status_code == 200:
        data = response.json()
        for ad in data.get("ads", []):
            price_raw = ad.get("price")
            title = ad.get("title")
            # Attention : pour d'autres sources, price est une chaîne à parser
            print(f"Annonce {ad['id']}: {title} - {price_raw}")
            
    elif response.status_code == 429:
        time.sleep(10)
        
except requests.exceptions.Timeout:
    pass

Ce script illustre la structure d'appel standard avec le header Authorization et le paramètre url. Il extrait les champs critiques (id, title, price) en vérifiant leur présence avant traitement. Pour plus de détails sur les endpoints disponibles, consultez notre documentation API Leboncoin.

En pratique : Une erreur 503 indique un incident technique ou une recherche vide ; aucune facture n'est émise dans ces cas.

Gérer les cas limites et les erreurs 503

Dans votre workflow de revente, la distinction entre une absence de résultats et un échec technique est souvent impossible à établir directement via les codes HTTP standards. Pour Vinted, Kleinanzeigen et Marktplaats, tant une recherche légitimement vide qu’une requête ayant échoué après plusieurs tentatives internes renvoie systématiquement le code 503 unexpected_error. Ce comportement unifié signifie que vous ne pouvez pas utiliser la présence ou l'absence d'annonces dans une réponse réussie pour valider votre filtre de recherche initial, car aucune réponse n'est retournée en cas d'échec.

Pour Leboncoin, le mécanisme diffère légèrement : les endpoints /search et /profile renvoient un code 200 avec une liste vide si aucun résultat n'est trouvé. Cependant, vous devez rester vigilant sur la gestion des timeouts. Une requête peut prendre jusqu'à 40 secondes en raison de tentatives silencieuses côté serveur pour récupérer les données. Il est impératif de configurer votre client HTTP avec un timeout d'au moins 45 secondes pour éviter qu'une latence normale ne soit interprétée comme une erreur.

En pratique : Ne débite jamais vos crédits sur la base du code 503. Le champ credits_charged vous indiquera si la requête a été facturée (valeur 1) ou non (valeur 0). Si ce champ est à 0, l'erreur correspond soit à une recherche vide, soit à un incident technique résolu automatiquement ; aucun coût n'est engagé.

Pour les autres sources de données, consultez la documentation spécifique pour comprendre comment chaque marketplace traite ses erreurs. Cette approche vous permet d'éviter des appels redondants inutiles et de préserver votre solde disponible sur LeBonDeal API.

Accéder à la documentation technique

Consultez nos endpoints et tarifs sur notre page dédiée.

Découvrir l'API LeBonDealLire la documentation

Intégrer le flux dans votre workflow de revente

Une fois les données extraites et normalisées, l'objectif est de réduire le délai entre la détection d'une opportunité et sa publication. La synchronisation manuelle introduit des latences qui nuisent à votre taux de conversion. Pour automatiser ce flux, vous devez mapper les champs retournés par l'API LeBonDeal vers le format requis par vos outils d'import (CSV, XML ou API native).

Voici la logique structurelle à respecter :

  • Normalisation des prix : Les chaînes retournées doivent être converties en nombres flottants pour les calculs de marge. La devise doit être isolée avant tout traitement comptable.
  • Gestion des images : Téléchargez les fichiers associés aux URLs fournies dans le champ photos ou images vers votre propre CDN ou stockage objet. Les marketplaces cibles refusent souvent l'import direct via URL distante pour des raisons de sécurité et de bande passante.
  • Attributs techniques : Mappez les champs tels que la taille, la marque ou l'état (status) selon le dictionnaire spécifique de chaque marketplace cible (Vinted exige un format différent de Leboncoin).
En pratique : Utilisez un ID unique stable pour éviter les doublons lors des mises à jour. Si une annonce disparaît du flux source, supprimez ou archivez l'offre correspondante chez vous afin de maintenir la fraîcheur de votre catalogue.

Pour les volumes élevés, privilégiez l'intégration directe via API Vinted si votre modèle le permet, ou utilisez des outils tiers compatibles avec vos exports JSON. Cette étape finale transforme un flux de données brut en inventaire actif et vendable.

FAQ

Comment extraire des annonces Leboncoin avec une API ?

Configurez vos filtres sur le site, copiez l'URL de la page de résultats et transmettez-la à l’endpoint `/api/v1/leboncoin/search` via un en-tête `Authorization: Bearer`. L'API renvoie les données structurées dans le champ `ads`, sans que vous ayez à gérer la requête HTTP directe vers LeBoncoin.

L'API LeBonDeal fonctionne-t-elle pour Kleinanzeigen ?

Oui, l’endpoint `/api/v1/kleinanzeigen/search` permet d'interroger les annonces allemandes en passant une URL de recherche valide. Les champs retournés incluent le titre, le prix et la localisation ; notez toutefois que ces derniers peuvent être vides selon le type d'annonce.

Faut-il payer par requête pour le scraping de données ?

Le modèle se base sur des crédits consommés à chaque appel effectif vers l'API. Les tarifs exacts et les plafonds évoluant régulièrement, consultez la page `/tarifs/` ou votre tableau de bord pour connaître vos conditions actuelles.

Quel timeout définir pour éviter les erreurs 503 ?

Une requête peut durer jusqu'à environ 40 secondes en cas de tentatives silencieuses côté serveur. Il est recommandé de configurer un timeout client d'au moins 45 secondes pour éviter des interruptions prématurées.

Articles liés