De bol API is het technische fundament waarmee verkopers hun bedrijfsprocessen op bol.com kunnen automatiseren. Of je nu orders wilt beheren, prijzen wilt aanpassen of advertentiecampagnes wilt draaien — de bol API maakt het mogelijk om alles programmatisch te regelen zonder handmatig door het verkoopportaal te klikken. In dit artikel leggen we uit hoe de bol API werkt, welke endpoints beschikbaar zijn, hoe je aan de slag gaat en wanneer je beter kunt kiezen voor een kant-en-klare integratie.
Wat is de bol API en waarom is het belangrijk?
API staat voor Application Programming Interface — een technische interface waarmee softwaresystemen met elkaar communiceren. De bol API stelt verkopers in staat om hun eigen software of tools van derden te koppelen aan het bol.com-platform. Dit betekent dat je processen zoals orderbeheer, voorraadupdates, prijsaanpassingen en verzendbevestigingen volledig kunt automatiseren.
Voor verkopers met meer dan 50 producten of meerdere verkoopkanalen is de bol API vrijwel onmisbaar. Handmatig werken via het Seller Dashboard (SDD) is tijdrovend en foutgevoelig. Met een API-koppeling bespaar je niet alleen uren per week, maar minimaliseer je ook fouten die kunnen leiden tot slechte prestatiescores.
Van Plaza API naar Retailer API
Bol.com heeft de oude Plaza API volledig vervangen door de modernere Retailer API. De Plaza API wordt niet meer ondersteund en nieuwe koppelingen zijn alleen mogelijk via de Retailer API. Deze biedt betere prestaties, meer endpoints, verbeterde beveiliging en uitgebreidere documentatie. Als je nog een oude Plaza-koppeling gebruikt, is het essentieel om zo snel mogelijk te migreren.
De drie API's van bol.com uitgelegd
Bol.com biedt drie afzonderlijke API's die samen het volledige scala aan verkoperfunctionaliteit dekken. Elke API heeft een eigen doel en set endpoints.
| API | Primaire functie | Belangrijkste endpoints | Geschikt voor |
|---|---|---|---|
| Retailer API | Volledig orderbeheer en productmanagement | Orders, Shipments, Returns, Offers, Inventory, Commission | Alle verkopers |
| Offer API | Productaanbod en prijsbeheer | Offers (CRUD), Pricing, Stock updates, Product content | Verkopers met grote catalogi |
| Advertiser API | Advertentiecampagnes en rapportage | Campaigns, Ad groups, Keywords, Performance reports | Verkopers met advertentiebudget |
Bol Retailer API
De Retailer API is de meest uitgebreide en meest gebruikte API van bol.com. Hiermee kun je vrijwel alle verkoopprocessen automatiseren: van het ophalen van nieuwe orders en het bevestigen van verzendingen tot het verwerken van retouren en het ophalen van commissieoverzichten. De Retailer API ondersteunt ook het beheren van je productaanbod, het bijwerken van voorraadniveaus en het ophalen van prestatierapporten.
Bol Offer API
De Offer API richt zich specifiek op het beheren van je productaanbod. Je kunt hiermee nieuwe producten uploaden, bestaande aanbiedingen aanpassen, prijzen wijzigen en voorraadniveaus bijwerken. Voor verkopers met honderden of duizenden producten is deze API essentieel om prijzen en voorraad real-time gesynchroniseerd te houden met je ERP- of WMS-systeem.
Bol Advertiser API
Met de Advertiser API automatiseer je je Sponsored Products-campagnes. Je kunt campagnes aanmaken, advertentiegroepen beheren, biedingen aanpassen en uitgebreide prestatierapporten ophalen — inclusief impressies, klikken, conversies en ACoS (Advertising Cost of Sale). Dit is bijzonder waardevol als je meerdere campagnes tegelijk draait en snel wilt optimaliseren op basis van data.
Belangrijkste endpoints en functionaliteiten
De bol API biedt tientallen endpoints. Hieronder een overzicht van de meest gebruikte endpoints per categorie, zodat je snel kunt inschatten welke je nodig hebt.
| Categorie | Endpoint | Methode | Beschrijving |
|---|---|---|---|
| Orders | /orders | GET | Alle openstaande orders ophalen |
| Orders | /orders/{orderId} | GET | Details van specifieke order bekijken |
| Verzending | /orders/{orderId}/shipment | PUT | Verzending bevestigen met track & trace |
| Retouren | /returns | GET | Openstaande retouren ophalen |
| Retouren | /returns/{returnId} | PUT | Retour afhandelen (accepteren/weigeren) |
| Aanbiedingen | /offers | POST | Nieuw productaanbod aanmaken |
| Aanbiedingen | /offers/{offerId} | PUT | Prijs, voorraad of conditie wijzigen |
| Voorraad | /offers/{offerId}/stock | PUT | Voorraadniveau bijwerken |
| Commissie | /commission | GET | Commissiepercentages per categorie opvragen |
| Inzichten | /insights/performance | GET | Prestatiescores en KPI's ophalen |
Authenticatie en beveiliging
De bol API gebruikt OAuth 2.0 voor authenticatie. Dit betekent dat je eerst API-credentials (Client ID en Client Secret) moet aanmaken in je bol.com-verkoopaccount. Met deze credentials vraag je een tijdelijk access token op dat je bij elke API-aanroep meestuurt.
Stap-voor-stap authenticatie instellen
- Inloggen op het partnerportaal — Ga naar je verkoopaccount op bol.com partner login en navigeer naar Instellingen > API-instellingen
- API-credentials aanmaken — Klik op "Nieuwe API-credentials aanmaken" en bewaar je Client ID en Client Secret veilig
- Access token opvragen — Stuur een POST-request naar het token-endpoint met je credentials (Base64-encoded) om een bearer token te ontvangen
- Token gebruiken — Voeg het token toe als Authorization-header bij elke API-aanroep
- Token vernieuwen — Access tokens verlopen na een bepaalde tijd; implementeer automatische token-vernieuwing in je applicatie
Bewaar je API-credentials nooit in publieke code-repositories of gedeelde documenten. Gebruik environment variables of een secret manager. Bij een vermoeden van een lek kun je je credentials direct intrekken via het partnerportaal.
Rate limits en best practices
Bol.com hanteert strikte rate limits om de API-servers te beschermen. Als je te veel verzoeken stuurt in een kort tijdsbestek, ontvang je een HTTP 429-fout (Too Many Requests). Het is belangrijk om je applicatie zo te ontwerpen dat deze de rate limits respecteert.
| Aspect | Limiet | Aanbeveling |
|---|---|---|
| Verzoeken per minuut | Variabel per endpoint | Implementeer exponential backoff bij 429-fouten |
| Bulk-operaties | Max. 1.000 items per batch | Splits grote updates in kleinere batches |
| Token-geldigheid | Beperkte levensduur | Cache tokens en vernieuw proactief voor expiratie |
| Dagelijkse limiet | Afhankelijk van accounttype | Monitor je API-gebruik via het partnerportaal |
| Concurrent requests | Beperkt aantal gelijktijdig | Gebruik een request queue met throttling |
Best practices voor API-gebruik
- Gebruik webhooks — In plaats van continu te pollen voor nieuwe orders, stel webhooks in zodat bol.com je server notificeert bij wijzigingen
- Implementeer retry-logica — Bij tijdelijke fouten (5xx-statuscodes) probeer het verzoek opnieuw met exponential backoff
- Cache responses — Sla veelgevraagde data (zoals commissiepercentages) lokaal op om onnodige API-aanroepen te vermijden
- Log alle API-calls — Houd een gedetailleerd logboek bij voor debugging en het monitoren van je API-gebruik
- Valideer input — Controleer data voordat je deze naar de API stuurt om onnodige foutmeldingen te voorkomen
Zelf bouwen vs. kant-en-klare integratie
Een van de belangrijkste beslissingen voor verkopers is of ze zelf software bouwen op de bol API of een bestaande tool gebruiken. Beide opties hebben voor- en nadelen die sterk afhangen van je technische kennis, budget en schaal.
| Criterium | Zelf bouwen | Kant-en-klare tool |
|---|---|---|
| Initiële kosten | €5.000–€15.000+ (ontwikkeltijd) | €0–€50/maand |
| Doorlooptijd | 2–6 maanden | Direct beschikbaar |
| Onderhoud | Continu nodig (API-updates) | Inbegrepen door aanbieder |
| Flexibiliteit | Volledig maatwerk mogelijk | Beperkt tot aangeboden functies |
| Risico | Hoog (developer-afhankelijkheid) | Laag (bewezen platform) |
| Schaalbaarheid | Afhankelijk van architectuur | Doorgaans goed schaalbaar |
| Support | Eigen verantwoordelijkheid | Helpdesk en documentatie beschikbaar |
| API-updates | Zelf implementeren | Automatisch bijgewerkt |
Wanneer zelf bouwen zinvol is
Zelf bouwen is alleen zinvol als je een zeer specifieke workflow hebt die geen enkele bestaande tool ondersteunt, je beschikt over een dedicated ontwikkelteam dat de koppeling langdurig kan onderhouden, en je bereid bent de doorlopende kosten van onderhoud en API-updates te dragen. In de praktijk geldt dit voor minder dan 5% van de verkopers.
Waarom de meeste verkopers kiezen voor een tool
Voor het overgrote deel van de verkopers is een kant-en-klare tool de verstandigste keuze. Tools zoals Boloo bieden uitgebreide integraties met de bol API zonder dat je zelf hoeft te programmeren. Je krijgt toegang tot functies zoals een product tracker, keyword verkenner, sales dashboard en automatische facturatie — allemaal gebouwd op de officiële bol API.
Veelgemaakte fouten bij het werken met de bol API
Veel verkopers en ontwikkelaars maken dezelfde fouten wanneer ze voor het eerst met de bol API werken. Door deze te kennen kun je kostbare tijd en geld besparen.
- Geen error handling implementeren — De API kan tijdelijk onbeschikbaar zijn of onverwachte responses terugsturen. Zonder goede foutafhandeling kan je hele systeem vastlopen
- Rate limits negeren — Te veel verzoeken in een kort tijdsbestek leidt tot blokkering. Implementeer altijd throttling en exponential backoff
- Credentials hardcoden — API-sleutels in de broncode plaatsen is een ernstig beveiligingsrisico. Gebruik altijd environment variables
- Niet testen in de sandbox — Bol.com biedt een testomgeving aan. Gebruik deze om je integratie te testen voordat je live gaat
- Verouderde documentatie volgen — De API wordt regelmatig bijgewerkt. Raadpleeg altijd de officiële documentatie op het bol.com developer portal
- Geen monitoring instellen — Zonder monitoring merk je problemen pas op wanneer klanten klagen. Stel alerts in voor fouten en vertragingen
Hoe Boloo de bol API optimaal benut
Boloo is volledig gebouwd op de officiële bol API en biedt verkopers een gebruiksvriendelijke interface bovenop de technische complexiteit. Waar je met de ruwe API zelf endpoints moet aanroepen en data moet verwerken, doet Boloo dit automatisch op de achtergrond.
- Product Tracker — Monitort concurrenten en prijswijzigingen via de Retailer API
- Product Database — Doorzoek het volledige bol.com-assortiment met geavanceerde filters
- Keyword Verkenner — Analyseer zoekvolumes en trends via API-data
- Ranking Checker — Volg je positie in zoekresultaten automatisch
- Listing Generator AI — Optimaliseer je productpagina's op basis van API-inzichten
- Sales Dashboard — Real-time omzet- en orderdata via de Retailer API
- Winstcalculator — Berekent marges inclusief actuele commissiepercentages
- Automatische Facturatie — Genereert facturen automatisch bij nieuwe orders
- E-mail Campagnes — Verstuur gerichte campagnes op basis van klantdata
- LVB Box Size Checker — Optimaliseer verzendkosten met de juiste doosformaten
Het voordeel van een tool als Boloo is dat je profiteert van alle mogelijkheden van de bol API zonder zelf technische kennis nodig te hebben. Updates aan de API worden automatisch verwerkt en je kunt direct aan de slag met het optimaliseren van je verkoop.
Veelgestelde vragen over de bol API
Waar vind ik de officiële bol API-documentatie?
De officiële documentatie is beschikbaar op het bol.com Developer Portal. Hier vind je gedetailleerde beschrijvingen van alle endpoints, voorbeeldcode, een sandbox-omgeving om te testen en changelogs met de laatste updates. De documentatie wordt regelmatig bijgewerkt bij nieuwe releases.
Wat is het verschil tussen de Retailer API en de oude Plaza API?
De Plaza API is volledig uitgefaseerd en wordt niet meer ondersteund. De Retailer API is de opvolger met betere prestaties, meer endpoints, verbeterde OAuth 2.0-authenticatie en uitgebreidere functionaliteit. Alle nieuwe koppelingen moeten via de Retailer API worden gebouwd. Bestaande Plaza-koppelingen werken niet meer.
Heb ik programmeerkennis nodig om de bol API te gebruiken?
Om direct met de API te werken heb je programmeerkennis nodig in een taal zoals Python, PHP, JavaScript of C#. Heb je geen technische achtergrond? Dan kun je beter kiezen voor een kant-en-klare tool zoals Boloo die de API-integratie voor je verzorgt zonder dat je zelf code hoeft te schrijven.
Zijn er kosten verbonden aan het gebruik van de bol API?
Het gebruik van de bol API zelf is gratis. Je betaalt geen extra kosten voor API-aanroepen. De kosten zitten in het ontwikkelen en onderhouden van je eigen software, of in het abonnement van een tool die de API voor je gebruikt. Bol.com brengt alleen de reguliere verkoopcommissie in rekening.
Hoe vaak wordt de bol API bijgewerkt?
Bol.com werkt de API regelmatig bij met nieuwe endpoints, verbeterde functionaliteit en beveiligingspatches. Grote updates worden vooraf aangekondigd via het Developer Portal met een migratieperiode. Het is belangrijk om deze changelogs te volgen als je een eigen koppeling onderhoudt — bij een kant-en-klare tool wordt dit automatisch afgehandeld.
Kan ik de bol API gebruiken voor meerdere verkoopaccounts?
Ja, je kunt de API gebruiken voor meerdere verkoopaccounts. Elk account heeft eigen API-credentials. Tools zoals Boloo ondersteunen het beheer van meerdere accounts vanuit één dashboard, wat het overzicht aanzienlijk vereenvoudigt voor verkopers met meerdere merken of winkels.
Start gratis met Boloo
Gebruik de tools van Boloo om slimmer te verkopen op bol.com. Probeer het gratis uit.
Probeer Boloo gratis
