bol product
One bol product: title, brand, authors / publishers for books, description, all images, categories with ids, every specification group (ingredients, nutrition, dimensions, technical data...), highlights, warnings, energy label, sustainability evidence, warranty, the best offer and the cheapest / fastest new and cheapest second-hand offers with seller, price, list price, unit price, delivery and deals, the number of offers, the review summary (average, distribution, AI topic summaries with sentiment counts) and the first reviews.
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 number in a bol.com/nl/nl/p/<name>/<id>/ link, or that link. Example: 9300000000788662 |
country | nl | be | nl (default) or be. |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/bol/v1/product?id=9300000000788662" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/bol/v1/product",
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/product");
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)
{"id": "9300000000788662","url": "https://www.bol.com/nl/nl/p/l-or-barista-xxl-lungo-profondo-5-x-10-koffiecups/9300000000788662/","title": "L'OR BARISTA XXL Extra Long Koffiecups - Intensiteit 8/12 - 5 x 10 capsules","subtitle": [],"brand": {"id": "14295086","name": "L'OR","url": "https://www.bol.com/nl/nl/pb/l-or/14295086/"},"rating": 4.8,"review_count": 89,"sponsored": false,"offer": {"offer_id": "c3d5cc70-c2fb-45be-bab2-34a3f9b9a642","seller": {"id": "0","name": "bol","rating": null,"url": null},"sold_by_bol": true,"price": 29.16,"currency": "EUR","list_price": 36.45,"list_price_label": "Adviesprijs","strikethrough": false,"unit_price": 0.58,"unit": "CU","select_price": null,"bundle_prices": null,"condition": "new","offer_type": "STANDARD","delivery": "Op voorraad. Voor 23:59 uur besteld, morgen in huis","delivery_by": "2026-11-05","release_date": null,"shipping_cost": 0,"delivered_within_48h": true,"scarce": false,"deals": [{"title": "Volumevoordeel op koffie","mechanism": "PRICE_OFF","id": "548461","url": "https://www.bol.com/nl/nl/cmp/maand-van-de-koffie-campagne/2179/"}],"loyalty_points": 5},"cheapest_new": {"offer_id": null,"seller": null,"sold_by_bol": false,"price": 29.16,"currency": "EUR","list_price": null,"list_price_label": null,"strikethrough": null,"unit_price": null,"unit": null,"select_price": null,"bundle_prices": null,"condition": "new","offer_type": null,"delivery": null,"delivery_by": null,"release_date": null,"shipping_cost": null,"delivered_within_48h": null,"scarce": null,"deals": [],"loyalty_points": null},"cheapest_secondhand": null,"offers_url": "https://www.bol.com/nl/nl/prijsoverzicht/l-or-barista-xxl-lungo-profondo-5-x-10-koffiecups/9300000000788662/?filter=new&sort=price&sortOrder…","categories": [{"id": "72182","name": "L'OR Barista compatible cups","url": "https://www.bol.com/nl/nl/l/l-or-barista-compatible-cups/72182/","path": [{"id": "36080","name": "Eten & Drinken"},{"id": "63487","name": "Frisdrank, sap, koffie en thee"},"… 2 more"]},{"id": "30271","name": "Koffiecups","url": "https://www.bol.com/nl/nl/l/koffiecups/30271/","path": [{"id": "36080","name": "Eten & Drinken"},{"id": "63487","name": "Frisdrank, sap, koffie en thee"},"… 1 more"]},"… 3 more"],"highlights": ["Compatibel met L’OR Barista","Cups","… 3 more"],"sustainability": {"evidences": [{"description": "Dit artikel draagt het Rainforest Alliance keurmerk. Dit keurmerk stelt strenge sociale en milieu-eisen binnen de gehele land- en bosbouw.","name": "Rainforest Alliance"}],"labels": [],"verdict": "MORE_SUSTAINABLE"},"energy_label": null,"family_id": null,"image": null,"description": "Lungo Profondo overtuigt je met zijn intense en kruidige aroma van geroosterde amandelen en uitdagend zoethout, afgerond met een glinsterend…","country": "nl","images": [{"url": "https://media.s-bol.com/NRyxLwAMknWN/EAv314/1200x1116.jpg","alt": "Doos L'OR BARISTA XXL capsules, extra lang, intensiteit 8, met koffiemachine en koffie.","usage": "primary"},{"url": "https://media.s-bol.com/mMOqqRQ12rkn/4636ox1/1500x844.jpg","alt": null,"usage": "video"},"… 12 more"],"video": [{"mediaType": "VIDEO","renditions": [{"preset": "large","url": "https://media.s-bol.com/mMOqqRQ12rkn/4636ox1/550x309.jpg"},{"preset": "video","url": "https://media.s-bol.com/N5LOO75k17Dvv/playlist.m3u8"},"… 2 more"]}],"brands": [{"id": "14295086","name": "L'OR","url": "https://www.bol.com/nl/nl/pb/l-or/14295086/","description": "L'OR is een koffiemerk van Franse origine dat letterlijk 'goud' betekent. L’OR heeft de ambitie om de beste koffie ter wereld naar de consum…"}],"authors": [],"publishers": [],"manufacturers": [],"specifications": [{"group": "Etiketinformatie","attributes": [{"key": "Ingredients","name": "Ingrediënten","value": "Gemalen koffie in capsules","description": null},{"key": "Allergens","name": "Allergenen","value": "Geen allergenen","description": null},"… 3 more"]},{"group": "Voedingswaarden (per 100g/ml)","attributes": [{"key": "NutVal Energy","name": "Energie (kJ)","value": "0 kJ","description": null},{"key": "NutVal Energy in kilocalories","name": "Energie (Kcal)","value": "0 kcal","description": null},"… 11 more"]},"… 5 more"],"unique_selling_points": [{"fittingSizeGuide": null,"label": "Smaakintensiteit","relatedProducts": [{"assets": [{"…": "2 fields"}],"availableAlternativesAssets": [{"…": "2 fields"}],"bestSellingOffer": {"…": "10 fields"},"cheapestRefurbished": {"…": "1 fields"},"distinctiveFeatures": [{"…": "2 fields"},{"…": "2 fields"}],"id": "9300000054521638","inKoboPlus": null,"originalReleaseDate": [],"specifications": {"…": "1 fields"},"title": "L'OR BARISTA XXL Double Ristretto Koffiecups - Intensiteit 11/12 - 5 x 10 capsules","url": "/nl/nl/p/l-or-barista-xxl-ristretto-5-x-10-koffiecups/9300000054521638/"},{"assets": [{"…": "2 fields"}],"availableAlternativesAssets": [{"…": "2 fields"}],"bestSellingOffer": {"…": "10 fields"},"cheapestRefurbished": {"…": "1 fields"},"distinctiveFeatures": [{"…": "2 fields"},{"…": "2 fields"}],"id": "9300000054521641","inKoboPlus": null,"originalReleaseDate": [],"specifications": {"…": "1 fields"},"title": "L'OR BARISTA XXL Double Barista Selection Koffiecups - Intensiteit 13/13 - 5 x 10 capsules","url": "/nl/nl/p/l-or-barista-xxl-barista-selection-5-x-10-koffiecups/9300000054521641/"},"… 1 more"],"requireSelection": false,"type": "Coffee Intensity","visible": true,"visualFeature": true},{"fittingSizeGuide": null,"label": "Aantal koffieverpakkingen","relatedProducts": [{"assets": [{"…": "2 fields"}],"availableAlternativesAssets": [{"…": "2 fields"}],"bestSellingOffer": {"…": "10 fields"},"cheapestRefurbished": {"…": "1 fields"},"distinctiveFeatures": [{"…": "2 fields"},{"…": "2 fields"}],"id": "9300000000788662","inKoboPlus": null,"originalReleaseDate": [],"specifications": {"…": "1 fields"},"title": "L'OR BARISTA XXL Extra Long Koffiecups - Intensiteit 8/12 - 5 x 10 capsules","url": "/nl/nl/p/l-or-barista-xxl-lungo-profondo-5-x-10-koffiecups/9300000000788662/"}],"requireSelection": false,"type": "Number of Coffee Packages","visible": false,"visualFeature": false}],"warnings": [{"id": "10c9c099-39bb-4a03-8ad6-d6905f684c49","linkReplacements": [],"message": "Let goed op of deze koffiecups in je koffiemachine passen.","type": "CONSUMER"},{"id": "b14d5d65-950b-4b42-907a-eb6eefac782e","linkReplacements": [],"message": "We raden je aan om voor gebruik de verpakking te lezen. Mogelijk verschilt informatie op de productpagina van de werkelijke informatie op de…","type": "POLICY"}],"hazard_labels": null,"commercial_warranty": null,"return_condition": {"conditionText": null},"pack_quantity": null,"number_of_pages": 0,"book_language": [],"book_binding": [],"fastest_new": {"offer_id": null,"seller": null,"sold_by_bol": false,"price": 29.16,"currency": "EUR","list_price": null,"list_price_label": null,"strikethrough": null,"unit_price": null,"unit": null,"select_price": null,"bundle_prices": null,"condition": "new","offer_type": null,"delivery": "Op voorraad. Voor 23:59 uur besteld, morgen in huis","delivery_by": "2026-11-05","release_date": null,"shipping_cost": null,"delivered_within_48h": null,"scarce": null,"deals": [],"loyalty_points": null},"offer_count": 1,"reviews_summary": {"rating": 4.8,"review_count": 89,"rating_distribution": [{"stars": 5,"count": 76},{"stars": 4,"count": 10},"… 3 more"],"topics": [{"id": "eb2fadce-3340-3d02-88f4-6a814e8d2fc5","label": "smaak","review_count": 57,"positive": 56,"neutral": 0,"negative": 1,"summary": "Klanten zijn zeer te spreken over de rijke en lekkere smaak van deze koffie. Slechts een enkeling vindt de smaak te sterk of afwijkend van d…"},{"id": "80438071-53b9-323f-acea-1124cbd5f736","label": "formaat en dosering","review_count": 25,"positive": 25,"neutral": 0,"negative": 0,"summary": "Het XXL-formaat wordt alom geprezen omdat gebruikers gemakkelijk één grote mok of twee kopjes koffie tegelijk kunnen zetten. Het bespaart ti…"},"… 3 more"],"summary": null},"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/"}},"… 4 more"],"…": "6 more fields","cached": false,"credits_used": 1}