bol API: producten en verkopersprijzen als JSON
bol heeft een eigen partner-API, maar die is er voor verkopers en laat je eigen assortiment zien. Deze API beantwoordt de andere vraag: wat staat er in het schap, wat kost het, en wie verkoopt het nog meer. Geen verkopersaccount nodig; het antwoord komt als JSON.
Endpoints
| endpoint | Wat je terugkrijgt | Verplicht |
|---|---|---|
| search | Zoeken op trefwoord, met paginering. Elke regel bevat het product-id en de url, titel, merk en prijs. | query |
| product/detail | Het volledige product op id of url: titel, merk, EAN en MPN, de buy-box-prijs en de productgegevens. | product_id |
| product/offers | Waar het om draait: elke verkoper die dit product aanbiedt, met prijs, staat en levertijd. | product_id |
| category | Een categorie doorbladeren op id, met dezelfde productregels als de zoekopdracht. | category_id |
Elke aanroep kost credits. Mislukte en geblokkeerde aanroepen zijn gratis.
Werkend voorbeeld
De prijs in de zoekresultaten is de buy-box-prijs, niet de laagste prijs. Wie werkelijk wil vergelijken, haalt product/offers op: daar staat pas wie er met wie concurreert.
curl -X POST https://api.reefapi.com/bol/v1/product/offers \
-H "x-api-key: JOUW_SLEUTEL" \
-H "content-type: application/json" \
-d '{"product_id": "9200000123456789"}'{
"ok": true,
"data": {
"offers": [
{
"seller": "...",
"price": 24.99,
"currency": "EUR",
"condition": "nieuw",
"delivery": "..."
}
]
},
"meta": { "record_count": 11, "cache_hit": false, "mode": "live" }
}In plaats van een eigen bol-scraper
Zelf bol.com uitlezen werkt de eerste dag prima. Daarna komen de dingen die je niet ziet: verandert de opbouw van de productpagina, dan geeft je parser een lege lijst in plaats van een fout, en bij een grotere run loopt de botbeveiliging erin.
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 berekend.
Voor een eenmalige klus blijft je eigen script goedkoper, dat zeggen we er eerlijk bij. Voor iets dat elke dag moet draaien zitten de kosten in storingen die niemand opmerkt.
Meer documentatie in het Nederlands
Grenzen en eerlijke kanttekeningen
- Dit is niet de officiële bol-partner-API en we hebben geen samenwerking met bol.
- De prijs in de zoekresultaten is de buy-box-prijs; de laagste prijs staat in product/offers.
- Publiceert bol geen EAN of MPN voor een artikel, dan komt het veld als null terug.
- Geen cache: elke aanroep laat de stand van dat moment zien.