bol product reviews

GET https://api.api.sh/bol/v1/reviews
1 credit / call e-commerce try it in the playground →

Reviews of one bol product: rating, title, text, pros and cons, nickname, location, age range, date, verified purchase, helpful votes and the reviewed variant, with the shop's sorts and star / topic filters. Pass next_cursor back as cursor; null on the last page.

Every response includes credits_used: the credits this call cost.

Part of the bol API: 8 endpoints with prices, use cases and example responses.

Parameters

nametypedescription
idrequired string The product id or its bol.com link. Example: 9300000000788662
sort helpful | newest | highest | lowest helpful (default), newest, highest, lowest.
rating integer Only reviews with this many stars (1-5).
topic string Only reviews about one topic: a reviews_summary.topics[].id from /bol/v1/product.
limit integer Reviews per page, 1-50 (default 10).
cursor string next_cursor from the previous page.

Every endpoint also takes fresh, raw, fields (see lean responses and caching).

Example

curl "https://api.api.sh/bol/v1/reviews?id=9300000000788662" \
  -H "x-api-key: $APISH_KEY"

Response

A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).

Example response (real call, trimmed: lists cut to 2 items, long text shortened, raw left out)

{"product_id": "9300000000788662","sort": "helpful","rating": null,"topic": null,"total": 89,"count": 10,"next_cursor": "eyJsYXN0SWQiOiI4NmU2NmU0Yy0wYzc4LTU1ZTQtYTJjOC0wYTQ1MTJmZGFkZjAiLCJsYXN0U3VibWlzc2lvbkRhdGVUaW1lIjoiMjAyMi0wNC0yMlQwNjoyODowNVoiLCJsYXN0VmFs…","reviews": [{"id": "11e81284-e106-522f-a10b-63a6f28d2a5d","rating": 4,"title": "Deze zijn wel heel erg sterk!","text": "Ik hou van een stevig bakkie koffie, had dan ook heel enthousiast Barista XXL cups sterkte 13 gekocht bij mijn nieuwe Barista apparaat, en d…","pros": ["Werken prima in de Barista","Smaak is goed"],"cons": ["persoonlijk vind ik ze te sterk (XXL 13)"],"author": "Pe7e333","location": "Nijmegen","age_range": "FROM_60_TO_69","date": "2022-03-03T16:01:54Z","verified": true,"translated": false,"refurbished_offer": false,"helpful": 21,"not_helpful": 3,"product": {"id": "9300000054521641","title": "L'OR BARISTA XXL Double Barista Selection Koffiecups - Intensiteit 13/13 - 5 x 10 capsules","url": "https://www.bol.com/nl/nl/p/l-or-barista-xxl-barista-selection-5-x-10-koffiecups/9300000054521641/"}},{"id": "0c325870-a1d5-4d84-a36c-6cb859d4ba04","rating": 5,"title": "Heerlijke koffie","text": "Nergens te koop in de supermarkt.maar wel bij jullie.fantastisch\n","pros": [],"cons": [],"author": "Lusiem","location": "Adam","age_range": null,"date": "2024-04-07T15:09:21.715Z","verified": true,"translated": false,"refurbished_offer": false,"helpful": 5,"not_helpful": 0,"product": {"id": "9300000000788662","title": "L'OR BARISTA XXL Extra Long Koffiecups - Intensiteit 8/12 - 5 x 10 capsules","url": "https://www.bol.com/nl/nl/p/l-or-barista-xxl-lungo-profondo-5-x-10-koffiecups/9300000000788662/"}},"… 8 more"],"cached": false,"credits_used": 1}
The fastest way to see the full response is the playground: it runs this endpoint with your account and shows the exact JSON.