Intégrer l'API Leboncoin dans une app no-code (Make, Zapier ou n8n)

L'intégration de l'API Leboncoin dans un environnement no-code s'effectue via des requêtes HTTP GET authentifiées vers les endpoints `/search` ou `/ad`. Cette méthode permet d'alimenter automatiquement vos bases de données ou alertes sans maintenir une infrastructure serveur complexe. Vous pouvez ainsi récupérer la liste des annonces, leurs prix et métadonnées directement dans Make, Zapier ou n8n.

Prérequis : Clé API et URL de recherche

Avant de configurer votre workflow sur Make, Zapier ou n8n, vous devez récupérer deux éléments distincts : vos identifiants d'accès et la source des données à extraire. La première étape consiste à générer une clé API depuis le tableau de bord LeBonDeal. Cette clé unique permet d'authentifier vos requêtes auprès du service LeBonDeal. Créez cette ressource via la section dédiée aux clés et copiez immédiatement sa valeur, car elle n'est visible qu'une seule fois lors de sa génération. En cas de perte ou de compromission potentielle, vous devrez révoquer l'ancienne clé pour en générer une nouvelle depuis cet espace sécurisé.

Le second prérequis concerne la structure des données à scraper. L'API Leboncoin ne permet pas de définir des filtres (prix, catégorie, rayon) directement via les paramètres de requête HTTP. Vous devez donc configurer votre recherche manuellement sur le site web en utilisant l'interface visuelle standard. Une fois vos critères définis, copiez l'intégralité de l'URL affichée dans la barre d'adresse du navigateur et collez-la comme paramètre url dans votre outil no-code. L'outil utilisera cette adresse exacte pour simuler une visite utilisateur légitime sur Leboncoin.

Configuration HTTP générique pour Make, Zapier et n8n

Pour intégrer l’API Leboncoin dans des environnements no-code, vous devez configurer un module HTTP standard (Requête Web ou HTTP Request). La méthode utilisée est systématiquement GET. L’URL de base reste constante : https://bot.lebondeal-bot.fr. Vous拼接z ensuite le chemin spécifique à votre besoin, par exemple /api/v1/leboncoin/search, pour former l’URI complète.

L’authentification repose sur un en-tête HTTP standard. Vous devez ajouter une entrée nommée Authorization dont la valeur est Bearer <votre_clé_api>. Ici, <votre_clé_api> représente strictement le jeton généré dans votre tableau de bord documentation. Ne copiez jamais la chaîne littérale YOUR_API_KEY, qui n’est qu’un placeholder technique. La clé ne doit être stockée que dans les variables d’environnement ou secrets du workflow, et jamais exposée en dur dans l’URL.

Le paramètre critique est url. Il contient l’adresse exacte de la recherche Leboncoin (issue de votre navigateur), incluant tous les filtres actifs. Les outils no-code ne recréent pas les filtres ; ils transmettent simplement cette URL telle quelle à l’API. Pour le corps de la requête, rien n’est nécessaire puisque tout passe dans les paramètres ou l’URL elle-même.

Exemple concret : Workflow Make (Integromat)

Make permet d'orchestrer des appels HTTP complexes grâce à ses modules natifs. Voici un exemple de workflow type qui interroge l'API Leboncoin pour récupérer une page d'annonces, puis itère sur chaque résultat afin d'en extraire les données structurées sans passer par du code externe.

# Simulation d'un script Python exécutant la logique du workflow
import os, requests, json
BASE_URL = os.environ.get("LEBONDEAL_BASE_URL", "https://bot.lebondeal-bot.fr") API_KEY  = os.environ["LEBONDEAL_API_KEY"] SEARCH_URL = "https://www.leboncoin.fr/recherche?category=1532" # Exemple
headers = {"Authorization": f"Bearer {API_KEY}"} params  = {"url": SEARCH_URL, "page": 1}
try: response = requests.get( f"{BASE_URL}/api/v1/leboncoin/search", headers=headers, params=params, timeout=45 )
if response.status_code == 200: data = response.json() ads = data.get("ads", [])
for ad in ads: print(f"ID: {ad['id']} | Prix: {ad['price']}€")
except requests.exceptions.HTTPError as e: if e.response.status_code == 429: print("Rate limited : attendre et réessayer.") elif e.response.status_code in [503, 401]: print(f"Erreur critique {e.response.status_code}")

Alternative avec Zapier

Zapier propose une approche différente de celle des outils open-source ou modulaires comme Make. L’interface est plus linéaire, ce qui réduit la courbe d’apprentissage mais limite le contrôle granulaire sur les flux JSON bruts. Vous ne configurez pas un scénario complexe avec des chemins conditionnels dès le départ ; vous enchaînez des modules séquentiellement.

Pour interroger l’API Leboncoin, utilisez le module Webhooks by Zapier (action « Custom Request »). Configurez les paramètres suivants :

• Method : GET
• URL : https://bot.lebondeal-bot.fr/api/v1/leboncoin/search?url=VOTRE_URL_RECHERCHE
• Headers : Ajoutez une ligne clé/valeur. Clé : Authorization, Valeur : Bearer VOTRE_CLE_API.

Zapier gère automatiquement l’encodage URL, ce qui simplifie le passage des paramètres complexes dans la chaîne de requête. Cependant, contrairement à Make où vous pouvez manipuler chaque champ du payload avant envoi, Zapier attend une structure HTTP standardisée. Si votre recherche nécessite des filtres spécifiques (catégorie, localisation), préparez l’URL complète sur Leboncoin.fr et copiez-la telle quelle dans le paramètre url.

L’avantage majeur de cette méthode est la simplicité du déploiement. Vous n’avez pas besoin de gérer des variables d’environnement complexes sur un serveur ; votre clé API reste stockée en tant que variable sécurisée au sein de l’intégration Zapier, accessible uniquement par ce scénario spécifique. Cela réduit les risques de fuite si vous partagez le lien du workflow avec une tierce partie non technique.

Pour la suite du pipeline, utilisez le module Formatter by Zapier (action « Text ») pour extraire des sous-chaînes si nécessaire, ou mappez directement les champs id, price et location vers votre destination finale. Notez que vous ne pouvez pas appeler l’endpoint /ad individuellement sans une étape de recherche préalable (/search) pour récupérer l’URL spécifique de chaque annonce, ce qui peut alourdir le workflow si vous traitez des volumes importants.

Pour plus de détails sur les champs retournés et la structure exacte du JSON, consultez la documentation dédiée à l’API Leboncoin.

Gestion des erreurs et timeout dans les workflows no-code

Le scraping de marketplace impose des délais d’attente variables. Le temps de réponse peut atteindre environ quarante secondes en cas d’incident temporaire, car le serveur effectue des tentatives silencieuses avant de renvoyer une erreur persistante. Vous devez configurer un timeout client supérieur à cette durée pour éviter les interruptions prématurées dans vos workflows no-code.

Les erreurs se divisent en deux catégories distinctes : celles liées au débit et celles liées à la disponibilité du service.

• Code 429 (rate_limited) : Ce statut indique que vous avez dépassé la limite de requêtes par clé ou par IP. Il n’y a pas d’en-tête HTTP spécifique à lire. Vous devez implémenter une logique de réessai avec un délai croissant après quelques secondes.
• Code 503 (unexpected_error) : Ce statut signale un incident technique persistant suite aux tentatives automatiques du serveur, ou une recherche légitimement vide sur certaines sources comme Vinted ou Kleinanzeigen. Les deux cas sont traités identiquement par l’API sans facturation de crédit. Vous devez réessayer plus tard, mais ne pas confondre ces deux situations au niveau du code source.

Pour gérer ces états sans bloquer le workflow entier, utilisez des routeurs conditionnels basés sur le code HTTP retourné. Si le statut est 429, appliquez un délai d’attente avant la prochaine itération. Si le statut est 503, vous pouvez choisir de réessayer immédiatement ou de marquer l’erreur comme temporaire selon votre stratégie de résilience. Consultez la documentation pour vérifier les statuts spécifiques à chaque source via ce lien.

FAQ

Articles liés