← Rylee Blog Bol

De bol Retailer API: toegang, versies en rate limits

Wat je met de bol Retailer API kunt, hoe je API-gegevens aanmaakt, welke versie je gebruikt en hoe je binnen de rate limits blijft.

Noud van Workum Laatst bijgewerkt 19 november 2026 5 minuten leestijd
De bol Retailer API: toegang, versies en rate limits

Als mensen het over "de bol API" hebben, bedoelen ze bijna altijd de Retailer API: de koppeling waarmee software je verkoopaccount kan uitlezen en bijwerken. Orders, verzendingen, aanbiedingen, retouren. Je maakt in je verkoopaccount client credentials aan, haalt daarmee een kortlevend token op bij login.bol.com en stuurt dat mee met elke aanvraag. Repricers, orderbeheersystemen en Rylee werken allemaal via diezelfde API.

Wat je ermee kunt

Onderdeel

Wat je ermee doet

Orders

Nieuwe en gewijzigde orders ophalen

Verzendingen

Een verzending bevestigen, met track-and-trace

Aanbiedingen (offers)

Prijs, voorraad en levertijd aanpassen

Retouren

Retouren ophalen en afhandelen

Commissie

De commissie per EAN en prijs opvragen

Producten en concurrerende aanbiedingen

Productinformatie en het aanbod van andere verkopers ophalen

Die laatste endpoints vervingen de oude Open API van bol (bol developers).

Adverteren valt erbuiten. Sponsored products beheer je via een aparte Advertising API, met eigen credentials: in je API-instellingen staat daarvoor een apart blok "Client credentials voor de Advertising API". Retailer-credentials werken daar niet, en andersom ook niet. Sinds bol in 2024 overstapte op een nieuwe sponsored products-omgeving, is dat de Advertising API v11.

Toegang regelen

In je verkoopaccount ga je naar de API-instellingen en kies je bij "Client credentials voor de Retailer API" voor Aanmaken. Je krijgt een client ID en een client secret. Behandel dat secret als een wachtwoord: wie het heeft, heeft toegang tot je account, dus het hoort nooit in code die anderen kunnen zien.

De API is beveiligd met OAuth2. Je stuurt client ID en secret met basic authentication naar login.bol.com en krijgt een token terug (bol: authenticatie). Dat token gaat als Bearer-token mee naar https://api.bol.com/retailer, met de versie in de Accept-header, bijvoorbeeld application/vnd.retailer.v10+json.

Een token is maar enkele minuten geldig. Gebruik het tot het verloopt en vraag dan pas een nieuw aan. Wie voor elke aanvraag een nieuw token haalt, loopt het risico dat bol zijn IP-adres blokkeert.

Een sandbox is er niet. Bol biedt een demo-omgeving met voorbeeldrequests, en raadt aan om je winkel tijdelijk op pauze te zetten als je een koppeling live wilt testen: de API blijft dan werken, maar klanten kunnen niet bestellen (bol: best practices).

Welke versie?

Versie 10 is sinds 1 oktober 2023 live. Voor onderdelen waar bol iets fundamenteel verandert, bestaat al versie 11 (bol: release planning). Belangrijk bij aanbiedingen: Offers v10 is verouderd en verdwijnt per 1 februari 2027. Bouw je nu iets nieuws voor aanbiedingen, doe dat dan op Offers v11 (bol: offers process). Bol kondigt nieuwe versies minstens 14 dagen vooraf aan.

Rate limits

Elk endpoint heeft een eigen limiet. Ga je eroverheen, dan krijg je status 429 Too Many Requests, met het aantal seconden dat je moet wachten (bol: conventies). De actuele limieten staan op de rate-limitpagina van bol. Hogere limieten krijg je alleen als je koppeling al optimaal is ingericht en de standaard toch niet volstaat (bol Partnerplatform: rate limits).

In de praktijk komt binnen de limieten blijven neer op minder en slimmer vragen. De limieten zijn gemaakt voor een gelijkmatige stroom, niet voor één grote batch per uur. Haal bij orders alleen wijzigingen op met de parameter change-interval-minute, in plaats van steeds alles (bol: orders best practices). Werk een aanbieding alleen bij als prijs of voorraad echt verandert. En bouw een wachtrij die bij een 429 de wachttijd uitleest en daarna opnieuw probeert.

Laat bol je een seintje geven

Nog beter dan slim pollen is niet pollen. Met subscriptions stuurt bol je zelf een bericht als er iets verandert, via een webhook, Google Cloud Pub/Sub of AWS SQS. Je kunt je onder meer abonneren op de status van asynchrone verzoeken (PROCESS_STATUS), op aanbiedingen die online of offline gaan, op wijzigingen in prijssterren en op concurrerende aanbiedingen. Sinds mei 2026 kan dat ook voor orders: bol meldt nieuwe en gewijzigde orders, zodat je de Orders-API niet meer steeds hoeft af te vragen (bol: Order Subscriptions).

Twee dingen om te weten. Een webhook moet via SSL bereikbaar zijn, anders weigert bol de registratie. En een subscription waarvan je endpoint geen 2xx-status teruggeeft, zet bol uit (bol: failing notifications). Bewaak dus of je abonnementen nog actief zijn.

Waar koppelingen op stuklopen

Veel schrijfacties zijn asynchroon: je krijgt eerst een process status terug, niet het resultaat. Wie niet controleert of die op succes komt te staan, weet niet of een verzending of prijswijziging echt is doorgekomen. Dat is de fout die we het vaakst zien.

Verder: heb je aparte verkoopaccounts voor Nederland en België, dan heeft elk account eigen credentials en dus een eigen token. En volg de developers-feed van bol, zodat je een versiewissel niet pas opmerkt als je koppeling stopt.

Reken er ook op dat de API niet altijd beschikbaar is. Bol streeft naar minstens 99% technische en 95% functionele beschikbaarheid per maand (bol: Definition of Service and Usage). Dat is ruim, maar 1% van een maand is nog altijd zo'n zeven uur. Een koppeling die bij een storing niet opnieuw probeert, mist orders of prijswijzigingen.

Zonder zelf te programmeren

Voor de meeste verkopers is zelf een koppeling bouwen niet nodig. Rylee is Gold Partner van bol en koppelt via de Retailer API met je verkoopaccount. Orders, omzet, winst en voorraad zie je in één dashboard, en dezelfde data voedt de bol repricer, de btw-facturen en de review-e-mails. Voor de advertentie-automatisering koppelt Rylee daarnaast met de Advertising API. Wil je je bol-data in ChatGPT of Claude gebruiken, dan kan dat met de bol MCP van Rylee, zonder zelf API-aanvragen te schrijven.

Vragen die we vaak krijgen

Wat is het verschil tussen de Retailer API en de Open API?

De Open API was de oude, openbare API van bol voor productinformatie. Bol heeft die vervangen door endpoints in de Retailer API, inclusief concurrerende aanbiedingen (bol developers).

Kan ik met één koppeling meerdere bol-winkels beheren?

Ja, maar elke winkel heeft eigen client credentials, dus je software vraagt per winkel een eigen token aan.

Kost de bol API geld?

Nee. Bol rekent niets voor API-aanroepen; je betaalt alleen de gewone verkoopcommissie. De kosten zitten in het bouwen en onderhouden van een eigen koppeling, of in het abonnement van een tool die de API voor je gebruikt.

← Alle artikelen

Wil je meer op bol.com verkopen?

We zijn er om je te helpen. Krijg toegang tot de meest geavanceerde tool voor productonderzoek, e-mailmarketing en data insights op de markt.

✓ 30 dagen gratis ✓ Maandelijks opzegbaar ✓ Nederlandse support 7 dagen p/w
Rylee · 30 dagen gratis 30 dagen gratis proberen