🇳🇱 API Marktplaats · Pays-Bas · Nouveau

API Marktplaats — annonces néerlandaises en JSON

Q: Pourquoi cette API prend-elle une URL plutôt que des paramètres séparés ?

Cela permet de reproduire exactement les filtres configurés sur marktplaats.nl sans les redéclarer dans l'appel API.

Q: Puis-je passer l'URL d'une annonce individuelle ?

Non, seules les pages de résultats de recherche sont acceptées, pas les fiches annonce individuelles.

Q: Suis-je facturé si la recherche ne retourne aucun résultat ?

Non, une recherche vide comme un échec technique renvoient une erreur 503 sans débit de crédit.

Q: Marktplaats partage-t-il le même solde de crédits que les autres sources ?

Oui, même clé API, même solde de crédits que les autres sources.

Marktplaats.nl est le Leboncoin des Pays-Bas. Passez-lui une URL de recherche déjà filtrée, l'API scrape la page de résultats et vous renvoie les annonces en JSON.

L'API Marktplaats fonctionne différemment des autres sources : au lieu de paramètres de recherche séparés, elle prend une URL de recherche Marktplaats.nl complète et renvoie les annonces trouvées sur cette page de résultats, en JSON. Facturation au crédit par requête réussie.

Marché : Pays-Bas Devise : EUR Format JSON Paramètre : URL de recherche

Obtenir une clé API → Documentation

Spécificité

Une recherche = une URL

Pas de query ou de zipcode séparés ici : configurez vos filtres directement sur marktplaats.nl (mot-clé, catégorie, prix, localisation…), copiez l'URL de la page de résultats depuis votre navigateur, et passez-la telle quelle à l'API.

URLs acceptées : /q/... (recherche par mot-clé) ou /l/<categorie>/... (navigation par catégorie)
URLs refusées : les fiches annonce individuelles (/v/...) — uniquement des pages de résultats de recherche

Endpoint

GET /api/v1/marktplaats/search
  ?url=<url_de_recherche_marktplaats.nl>

Authorization: Bearer <votre_cle_api>

Exemple

Requête et réponse

Recherche du mot-clé « fiets » (vélo, en néerlandais).

curl -H "Authorization: Bearer TA_CLE_API" \
  "https://bot.lebondeal-bot.fr/api/v1/marktplaats/search?url=https%3A%2F%2Fwww.marktplaats.nl%2Fq%2Ffiets%2F"

import requests

resp = requests.get(
    "https://bot.lebondeal-bot.fr/api/v1/marktplaats/search",
    headers={"Authorization": "Bearer TA_CLE_API"},
    params={"url": "https://www.marktplaats.nl/q/fiets/"},
)
data = resp.json()
print(data["count"], "annonce(s) trouvée(s)")
for item in data["items"]:
    print(item["title"], item["price"])

Réponse 200

{
  "items": [
    {
      "id": "m1234567890",
      "title": "Herenfiets 28 inch",
      "description": "Nette staat, weinig gebruikt.",
      "price": "85.00 EUR",
      "city": "Utrecht",
      "date": "Vandaag, 10:32",
      "photos": ["https://images.marktplaats.com/..."],
      "seller_name": "Jan",
      "seller_verified": false,
      "is_top_ad": false,
      "attributes": { "Conditie": "Gebruikt" },
      "url": "https://www.marktplaats.nl/v/.../m1234567890"
    }
  ],
  "count": 1,
  "total_count": 214,
  "credits_charged": 1,
  "credits_remaining": 9990
}

Réponse

Champs renvoyés

Champ	Type	Description
`id`	string	Identifiant unique de l'annonce
`title`	string	Titre de l'annonce
`description`	string	Description courte affichée sur la page de résultats
`price`	string	Prix formaté avec devise, ex. `"85.00 EUR"`
`city`	string	Ville du vendeur
`date`	string	Date de publication telle qu'affichée sur Marktplaats
`photos`	array	URLs des photos de l'annonce
`seller_name`	string	Nom affiché du vendeur
`seller_verified`	boolean	Vendeur vérifié par Marktplaats ou non
`is_top_ad`	boolean	Annonce mise en avant (top-annonce)
`attributes`	object	Attributs spécifiques à la catégorie (état, etc.)
`url`	string	Lien direct vers l'annonce

En plus de la liste items, la réponse inclut count (résultats sur cette page), total_count (résultats totaux de la recherche), credits_charged et credits_remaining.

Erreurs

Codes d'erreur

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

Une recherche techniquement échouée après plusieurs tentatives internes et une recherche légitimement vide renvoient toutes les deux une erreur 503 — impossible de les distinguer côté client. Dans les deux cas, aucun crédit n'est débité. Seul le code 400 invalid_url intervient avant tout scraping, si l'URL n'est pas reconnue.

Limites

Limites techniques

60 requêtes / 60 secondes spécifiquement pour cette API
30 requêtes / minute par clé API — garde-fou partagé entre toutes les API activées sur le compte
180 requêtes / minute par adresse IP
Une requête peut prendre jusqu'à ~40 secondes en cas d'incident temporaire (nouvelles tentatives automatiques avant réponse) — prévoyez un timeout client d'au moins 45 secondes

Ces limites techniques s'ajoutent aux plafonds de dépense configurables (jour / mois / maximum) propres à chaque API. Coût par requête et plafonds actuels : tableau de bord API.

Sécurité

Authentification

Chaque requête doit inclure votre clé API dans l'en-tête Authorization, au format Bearer. Générez une clé depuis votre tableau de bord.

En-tête HTTP

Authorization: Bearer lbd_live_xxxxxxxxxxxxxxxxxxxxxxxx

Votre clé n'est affichée qu'une seule fois à sa création. En cas de perte, révoquez-la et générez-en une nouvelle. Ne la placez jamais dans du code front-end (JS navigateur) — elle serait visible par n'importe qui.

Usage

Cas d'usage typiques

Expansion Pays-Bas

Étendre une activité de revente ou de veille déjà en place sur Leboncoin ou Kleinanzeigen au marché néerlandais.

Sourcing transfrontalier

Repérer des opportunités d'achat aux Pays-Bas, à prix souvent différent du marché français ou allemand.

Veille multi-pays

Suivre une même catégorie de produits sur plusieurs marchés européens en parallèle.

Exemples détaillés : veille concurrence, revente.

FAQ

Questions fréquentes

Pourquoi cette API prend-elle une URL plutôt que des paramètres séparés ?

Ça permet de reproduire exactement les filtres configurés sur marktplaats.nl (catégorie, prix, localisation, tri) sans avoir à les redéclarer dans l'appel API — vous configurez votre recherche dans le navigateur, vous copiez l'URL.

Puis-je passer l'URL d'une annonce individuelle ?

Non, seules les pages de résultats de recherche (/q/... ou /l/...) sont acceptées, pas les fiches annonce (/v/...).

Suis-je facturé si la recherche ne retourne aucun résultat ?

Une recherche légitimement vide et un échec technique renvoient tous les deux une erreur 503, sans distinction possible côté client — et dans les deux cas, aucun crédit n'est débité.

Marktplaats partage-t-il le même solde de crédits que les autres sources ?

Oui, même clé API, même solde de crédits que Leboncoin, Vinted et Kleinanzeigen.

Démarrer

Commencez avec l'API Marktplaats

Obtenir une clé API → Retour au hub API

API Marktplaats — annonces néerlandaises en JSON

Une recherche = une URL

Requête et réponse

Champs renvoyés

Codes d'erreur

Limites techniques

Authentification

Cas d'usage typiques

Expansion Pays-Bas

Sourcing transfrontalier

Veille multi-pays

Questions fréquentes

Commencez avec l'API Marktplaats

Produit

Sources API

Ressources

Entreprise & légal