API

Marktplaats API: advertenties als JSON

Marktplaats heeft wel een zakelijke koppeling, maar die is bedoeld voor verkopende partijen en toont je eigen advertenties. Deze API beantwoordt de andere vraag: wat staat er op de markt, voor welke prijs en bij welke verkoper. Geen account nodig, het antwoord komt als JSON binnen.

Haal een gratis sleutel Volledige documentatie: elk endpoint, elke parameter →

Endpoints

endpoint	Wat je terugkrijgt	Verplicht
search	Zoeken op trefwoord of categorie, met filters, sortering, locatie en offset-paginering (30 per keer).	allemaal optioneel
listing	De volledige advertentie op item_id en/of vip_url, aangevuld met prijs, beschikbaarheid en de overige productgegevens.	allemaal optioneel
categories	De categorieboom uit de zoekfacetten, of het doorbladeren van één categorie (niveau 1 of 2) met de bijbehorende advertenties.	allemaal optioneel
seller_listings	Alle actieve advertenties van één verkoper, met offset-paginering. De verkopersnaam wordt automatisch omgezet naar het juiste id.	seller_id

Elke aanroep kost credits. Mislukte en geblokkeerde aanroepen zijn gratis.

Werkend voorbeeld

De zoekopdracht levert 30 advertenties per aanroep. Wie een hele categorie wil doorlopen, werkt met offset en houdt zelf bij welke item_id's al gezien zijn.

Verzoek

curl -X POST https://api.reefapi.com/marktplaats/v1/search \
  -H "x-api-key: JOUW_SLEUTEL" \
  -H "content-type: application/json" \
  -d '{"query": "racefiets", "limit": 30}'

Antwoord (ingekort)

{
  "ok": true,
  "data": {
    "results": [
      {
        "item_id": "m1234567890",
        "title": "...",
        "price": 450,
        "currency": "EUR",
        "location": "...",
        "url": "https://www.marktplaats.nl/..."
      }
    ]
  },
  "meta": { "record_count": 30, "cache_hit": false, "mode": "live" }
}

In plaats van een eigen Marktplaats-scraper

Zelf Marktplaats uitlezen werkt de eerste dag. Daarna gebeurt er twee keer iets wat je niet ziet: verandert de opbouw van de resultaten, dan geeft je parser een lege lijst in plaats van een foutmelding, en slaat de botbeveiliging aan, dan wordt je verzoek stil geweigerd.

Hier ligt het onderhoud bij ons: verandert het schema, dan repareren wij de engine; is er een blokkade, dan komt er een foutcode terug en wordt die aanroep niet in rekening gebracht.

Voor een eenmalige klus is je eigen script goedkoper, dat zeggen we er eerlijk bij. Voor iets dat elke dag moet draaien zit de kostenpost niet in de code maar in storingen die niemand opmerkt.

This page in English →Volledige documentatie: elk endpoint, elke parameter →

Meer documentatie in het Nederlands

bol API — documentatie

Grenzen en eerlijke kanttekeningen

Dit is niet de officiële Marktplaats-koppeling en we hebben geen samenwerking met Marktplaats.
Zoeken levert 30 resultaten per aanroep; verder bladeren gaat via offset.
Publiceert een advertentie geen prijs — bijvoorbeeld 'bieden' — dan komt het veld als null terug; we verzinnen er geen bedrag bij.
Geen cache: elke aanroep laat de stand van dat moment zien.