bol product reviews
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
| name | type | description |
|---|---|---|
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" import os, requests
res = requests.get(
"https://api.api.sh/bol/v1/reviews",
params={"id": "9300000000788662"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/bol/v1/reviews");
url.searchParams.set("id", "9300000000788662");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); 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}