Kleinanzeigen est l'équivalent allemand de Leboncoin. Interrogez-le par mots-clés, catégorie, prix ou zone, et recevez des annonces structurées, prix en euros.
Pas de query ou de plz séparés : configurez vos filtres directement sur kleinanzeigen.de, copiez l'URL de la page de résultats depuis votre navigateur, et passez-la telle quelle à l'API.
GET /api/v1/kleinanzeigen/search
?url=<url_de_recherche_kleinanzeigen.de>
Authorization: Bearer <votre_cle_api>Extrait des champs disponibles. Liste complète dans la documentation technique.
| Champ | Type | Description |
|---|---|---|
id | string | Identifiant unique de l'annonce |
title | string | Titre de l'annonce (allemand) |
description | string | Texte complet de l'annonce |
price | string | Prix formaté avec devise, ex. "150.00 EUR" |
category | string | Catégorie Kleinanzeigen |
city | string | Ville, avec code postal allemand (PLZ) le cas échéant |
seller_name | string | Nom affiché du vendeur (privé / professionnel) |
photos | array | URLs des photos |
url | string | Lien direct vers l'annonce |
La réponse inclut aussi count, total_count, credits_charged et credits_remaining.
curl -H "Authorization: Bearer TA_CLE_API" \
"https://bot.lebondeal-bot.fr/api/v1/kleinanzeigen/search?url=https%3A%2F%2Fwww.kleinanzeigen.de%2Fs-fahrrad%2Fk0"{
"items": [
{
"id": "19273xxxx",
"title": "Fahrrad 28 Zoll",
"price": "150.00 EUR",
"city": "Berlin, 10115",
"seller_name": "Markus",
"url": "https://www.kleinanzeigen.de/..."
}
],
"count": 1,
"total_count": 356,
"credits_charged": 1,
"credits_remaining": 9990
}| Code | Erreur | Signification |
|---|---|---|
400 | invalid_url | Le paramètre url est manquant ou invalide pour cette API |
401 | unauthorized | Clé API absente, invalide ou révoquée |
402 | insufficient_credits | Solde de crédits insuffisant |
402 | account_paused | Compte en pause (solde ou cap de dépenses global atteint) |
402 | api_limit_reached | Plafond jour/mois/max de cette API atteint |
403 | api_not_activated | API non activée sur le compte |
429 | rate_limited | Trop de requêtes (limite par clé ou par IP dépassée) |
503 | unexpected_error | Incident temporaire persistant malgré plusieurs tentatives internes |
503 — impossible de les distinguer côté client, mais aucun crédit n'est débité dans les deux cas.
En plus d'un plafond de requêtes/minute propre à cette API, deux garde-fous s'appliquent à toutes les API du compte : 30 requêtes/minute par clé API, et 180 requêtes/minute par adresse IP. Une requête peut prendre jusqu'à ~40 secondes en cas d'incident temporaire — prévoyez un timeout client d'au moins 45 secondes.
Étendre une activité de revente ou de veille déjà en place sur Leboncoin au marché allemand.
Repérer des opportunités d'achat en Allemagne, à prix souvent différent du marché français.
Identifier des annonces publiées par des professionnels dans une catégorie ou région donnée.
Exemples détaillés : prospection, veille concurrence.
Les titres et descriptions sont renvoyés tels que publiés, en allemand, sans traduction automatique par défaut.
Configurez le filtre de localisation directement sur kleinanzeigen.de, puis copiez l'URL de résultats — le PLZ y est déjà inclus.
Non, seules les pages de résultats de recherche sont acceptées, pas les fiches annonce individuelles.
Une recherche vide et un échec technique renvoient tous les deux une erreur 503, sans distinction possible côté client — et sans débit de crédit dans les deux cas.
Oui, toutes les sources partagent le même solde de crédits, consultable et rechargeable depuis un unique tableau de bord.
LeBonDeal
Bot Discord gratuit pour vos alertes Leboncoin, et API à la demande pour extraire des données Leboncoin, Vinted, Kleinanzeigen et Marktplaats en JSON.
© LeBonDeal — Tous droits réservés.