--- type: "firecrawl-provider" description: "bol.com (bol.com/nl, the largest Dutch and Belgian marketplace) public storefront: keyword search and product details with the buy-box price, seller, delivery promise, EAN, specifications and images. Prices in EUR." use_when: "bol.com (bol.com/nl, the largest Dutch and Belgian marketplace) public storefront: keyword search and product details with the buy-box price, seller, delivery promise, EAN, specifications and images. Prices in EUR." categories: "Retail" capabilities: 2 credits_per_call: 5 --- # bol.com on Firecrawl Alexandria bol.com (bol.com/nl, the largest Dutch and Belgian marketplace) public storefront: keyword search and product details with the buy-box price, seller, delivery promise, EAN, specifications and images. Prices in EUR. - Categories: Retail - Category index: [Retail category](https://firecrawl.dev/alexandria/agents/categories/retail) - Provider key: `bol-com` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/bol-com) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/bol-com/openapi.json) ## Capabilities - [Product](https://firecrawl.dev/alexandria/agents/providers/bol-com/products/product): Get public bol.com product details by product id or URL: title, brand, EAN, buy-box EUR price and reference price, seller, delivery promise and shipping cost, availability, rating and review count, category path, specifications and images. - [Search](https://firecrawl.dev/alexandria/agents/providers/bol-com/products/search): Search bol.com (Dutch storefront) by keyword and return one result page (about 24 products): product id, title, brand, EUR price and reference price, buy-box seller, rating and review count, delivery text and date, sponsored flag and URL, plus the input for the next page. Pages 1-20; bol.com itself serves at most max_page pages. ## 1. Choose this provider when bol.com (bol.com/nl, the largest Dutch and Belgian marketplace) public storefront: keyword search and product details with the buy-box price, seller, delivery promise, EAN, specifications and images. Prices in EUR. ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "bol-com", "capability": "products/product", "options": { "product_id": "1004004012362052" } } ``` ## 3. Add provider options Use only the options needed for the task: - `product_id` (string): bol.com product id, the number at the end of a product URL (1004004012362052). Pattern: ^[0-9]{10,20}$. Example: `` - `url` (string): HTTPS bol.com product URL (/nl/nl/p/{slug}/{id}/). Supply this or product_id. Pattern: ^https://(?:www\.)?bol\.com/(?:nl|be)/(?:nl|fr)/p/[^/?#]+/[0-9]{10,20}/?(?:[?#].*)?$. Example: `` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "bol-com", capability: "products/product", options: { product_id: "1004004012362052", }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "bol-com", "capability": "products/product", "options": { "product_id": "1004004012362052" } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "bol-com", "capability": "products/product", "options": { "product_id": "1004004012362052" } } }' ``` ### CLI ```sh firecrawl scrape 'bol-com/products/product' \ --options '{"product_id":"1004004012362052"}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "bol-com", "capability": "products/product", "options": { "product_id": "1004004012362052" } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "bol-com", "capability": "products/product", "options": { "product_id": "1004004012362052" } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "availability": "InStock", "availability_text": "Op voorraad. Voor 23:59 uur besteld, maandag in huis", "available": true, "brand": "999 Games", "category_path": [ "Speelgoed", "Spellen", "Bordspellen" ], "country": "NL", "currency": "EUR", "delivery_date": "2026-10-26", "ean": "8717249196235", "id": "1004004012362052", "images": [ "https://media.s-bol.com/3n2QVp1KOz2n/mZmwlAR/1133x1200.jpg", "https://media.s-bol.com/m4Qo6NPN28qn/r0mvr6E/1200x1169.jpg", "https://media.s-bol.com/JwqmAg2MK7mv/r0mvr6E/1200x900.jpg" ], "list_price": 44.99, "list_price_label": "Adviesprijs", "observed_at_ms": 1792807200000, "price": 34.99, "rating": 4.7, "review_count": 1300, "seller": "bol", "seller_id": "0", "seller_rating": null, "shipping_cost": 0, "specifications": [ { "group": "Afmetingen & Maten", "name": "Verpakkingsgewicht", "value": "1.31 kg" }, { "group": "Speleigenschappen", "name": "Speeltijd", "value": "75 minuten" }, { "group": "Speleigenschappen", "name": "Spelsoort", "value": "Strategisch spel" }, { "group": "Speleigenschappen", "name": "Taal spel", "value": "Nederlands" }, { "group": "Speleigenschappen", "name": "Taal handleiding", "value": "Nederlands" }, { "group": "Speleigenschappen", "name": "Aantal benodigde accu's/batterijen", "value": "0" }, { "group": "Productinformatie", "name": "Merk", "value": "999 Games" }, { "group": "Productinformatie", "name": "MPN (Manufacturer Part Number)", "value": "999-KOL01B" }, { "group": "Productinformatie", "name": "EAN", "value": "8717249196235" }, { "group": "Productinformatie", "name": "Editie", "value": "Catan Basisspel" }, { "group": "Productinformatie", "name": "Materiaal", "value": "Kunststof" }, { "group": "Mogelijke vereisten instellen en gebruik", "name": "App vereist voor volledige functionaliteit", "value": "Nee" } ], "title": "999 Games - Catan - Basisspel - Bordspel - Het populaire handelsspel - 15+ spellenprijzen wereldwijd - Gezelschapsspel - Familiespel", "url": "https://www.bol.com/nl/nl/p/999games-catan-basisspel/1004004012362052/" } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Product - Capability: `products/product` - Description: Get public bol.com product details by product id or URL: title, brand, EAN, buy-box EUR price and reference price, seller, delivery promise and shipping cost, availability, rating and review count, category path, specifications and images. - Instructions: Get public bol.com product details by product id or URL: title, brand, EAN, buy-box EUR price and reference price, seller, delivery promise and shipping cost, availability, rating and review count, category path, specifications and images. - Cost: 5 credits per call - Capability file: [Product](https://firecrawl.dev/alexandria/agents/providers/bol-com/products/product) Accepted options: - `product_id` (string): bol.com product id, the number at the end of a product URL (1004004012362052). Pattern: ^[0-9]{10,20}$. Example: `` - `url` (string): HTTPS bol.com product URL (/nl/nl/p/{slug}/{id}/). Supply this or product_id. Pattern: ^https://(?:www\.)?bol\.com/(?:nl|be)/(?:nl|fr)/p/[^/?#]+/[0-9]{10,20}/?(?:[?#].*)?$. Example: `` Response schema example: ```json { "availability": "InStock", "availability_text": "Op voorraad. Voor 23:59 uur besteld, maandag in huis", "available": true, "brand": "999 Games", "category_path": [ "Speelgoed", "Spellen", "Bordspellen" ], "country": "NL", "currency": "EUR", "delivery_date": "2026-10-26", "ean": "8717249196235", "id": "1004004012362052", "images": [ "https://media.s-bol.com/3n2QVp1KOz2n/mZmwlAR/1133x1200.jpg", "https://media.s-bol.com/m4Qo6NPN28qn/r0mvr6E/1200x1169.jpg", "https://media.s-bol.com/JwqmAg2MK7mv/r0mvr6E/1200x900.jpg" ], "list_price": 44.99, "list_price_label": "Adviesprijs", "observed_at_ms": 1792807200000, "price": 34.99, "rating": 4.7, "review_count": 1300, "seller": "bol", "seller_id": "0", "seller_rating": null, "shipping_cost": 0, "specifications": [ { "group": "Afmetingen & Maten", "name": "Verpakkingsgewicht", "value": "1.31 kg" }, { "group": "Speleigenschappen", "name": "Speeltijd", "value": "75 minuten" }, { "group": "Speleigenschappen", "name": "Spelsoort", "value": "Strategisch spel" }, { "group": "Speleigenschappen", "name": "Taal spel", "value": "Nederlands" }, { "group": "Speleigenschappen", "name": "Taal handleiding", "value": "Nederlands" }, { "group": "Speleigenschappen", "name": "Aantal benodigde accu's/batterijen", "value": "0" }, { "group": "Productinformatie", "name": "Merk", "value": "999 Games" }, { "group": "Productinformatie", "name": "MPN (Manufacturer Part Number)", "value": "999-KOL01B" }, { "group": "Productinformatie", "name": "EAN", "value": "8717249196235" }, { "group": "Productinformatie", "name": "Editie", "value": "Catan Basisspel" }, { "group": "Productinformatie", "name": "Materiaal", "value": "Kunststof" }, { "group": "Mogelijke vereisten instellen en gebruik", "name": "App vereist voor volledige functionaliteit", "value": "Nee" } ], "title": "999 Games - Catan - Basisspel - Bordspel - Het populaire handelsspel - 15+ spellenprijzen wereldwijd - Gezelschapsspel - Familiespel", "url": "https://www.bol.com/nl/nl/p/999games-catan-basisspel/1004004012362052/" } ``` ### Search - Capability: `products/search` - Description: Search bol.com (Dutch storefront) by keyword and return one result page (about 24 products): product id, title, brand, EUR price and reference price, buy-box seller, rating and review count, delivery text and date, sponsored flag and URL, plus the input for the next page. Pages 1-20; bol.com itself serves at most max_page pages. - Instructions: Search bol.com (Dutch storefront) by keyword and return one result page (about 24 products): product id, title, brand, EUR price and reference price, buy-box seller, rating and review count, delivery text and date, sponsored flag and URL, plus the input for the next page. Pages 1-20; bol.com itself serves at most max_page pages. - Cost: 5 credits per call - Capability file: [Search](https://firecrawl.dev/alexandria/agents/providers/bol-com/products/search) Accepted options: - `page` (number): page Example: `1` - `query` (string, required): Search keywords as typed in the bol.com search box (Dutch works best). Example: `` Response schema example: ```json { "count": 5, "country": "NL", "has_more": true, "max_page": 7, "next_input": { "page": 2, "query": "catan" }, "observed_at_ms": 1792807200000, "page": 1, "query": "catan", "results": [ { "availability_text": "Op voorraad. Voor 23:59 uur besteld, maandag in huis", "available": true, "brand": "999 Games", "currency": "EUR", "delivery_date": "2026-10-26", "ean": null, "id": "1004004012362052", "image_url": "https://media.s-bol.com/3n2QVp1KOz2n/mZmwlAR/550x582.jpg", "list_price": 44.99, "list_price_label": "Adviesprijs", "price": 34.99, "rating": 4.7, "review_count": 1300, "seller": "bol", "seller_id": "0", "sponsored": false, "title": "999 Games - Catan - Basisspel - Bordspel - Het populaire handelsspel - 15+ spellenprijzen wereldwijd - Gezelschapsspel - Familiespel", "url": "https://www.bol.com/nl/nl/p/999games-catan-basisspel/1004004012362052/" }, { "availability_text": "Op voorraad. Voor 23:59 uur besteld, maandag in huis", "available": true, "brand": "999 Games", "currency": "EUR", "delivery_date": "2026-10-26", "ean": null, "id": "9200000109319378", "image_url": "https://media.s-bol.com/gVWZ0Y8MmAZ3/7PLD7G/550x459.jpg", "list_price": 84.99, "list_price_label": "Adviesprijs", "price": 73.99, "rating": 4.7, "review_count": 1300, "seller": "bol", "seller_id": "0", "sponsored": false, "title": "999 Games - Catan: Big Box - Bordspel", "url": "https://www.bol.com/nl/nl/p/catan-big-box/9200000109319378/" }, { "availability_text": "Op voorraad. Voor 23:59 uur besteld, maandag in huis", "available": true, "brand": "999 Games", "currency": "EUR", "delivery_date": "2026-10-26", "ean": null, "id": "9300000243677966", "image_url": "https://media.s-bol.com/BZWpLQjEBpYo/zmyQYmY/550x537.jpg", "list_price": null, "list_price_label": null, "price": 44.99, "rating": 4.7, "review_count": 1300, "seller": "bol", "seller_id": "0", "sponsored": false, "title": "999 Games - Catan Voordeelbundel! Basis + Uitbreiding 5/6 bundel", "url": "https://www.bol.com/nl/nl/p/999-games-catan-voordeelbundel-basis-uitbreiding-5-6-bundel/9300000243677966/" }, { "availability_text": "Op voorraad. Voor 23:59 uur besteld, maandag in huis", "available": true, "brand": "999 Games", "currency": "EUR", "delivery_date": "2026-10-26", "ean": null, "id": "1004004012362054", "image_url": "https://media.s-bol.com/mNyZ9qmwNyNA/Z8wo7yg/550x581.jpg", "list_price": null, "list_price_label": null, "price": 42.99, "rating": 4.7, "review_count": 1300, "seller": "bol", "seller_id": "0", "sponsored": false, "title": "999 Games - Catan: Uitbreiding Zeevaarders - Bordspel", "url": "https://www.bol.com/nl/nl/p/999-games-zeevaarders-van-catan/1004004012362054/" }, { "availability_text": "Op voorraad. Voor 23:59 uur besteld, maandag in huis", "available": true, "brand": "999 Games", "currency": "EUR", "delivery_date": "2026-10-26", "ean": null, "id": "1004004011092718", "image_url": "https://media.s-bol.com/Y9qRWN8z1kvA/2k96ygK/550x720.jpg", "list_price": 12.99, "list_price_label": "Adviesprijs", "price": 10.66, "rating": 4.4, "review_count": 99, "seller": "bol", "seller_id": "0", "sponsored": false, "title": "999 Games - Catan: Het Snelle Kaartspel - Vlot kaartspel voor 2-4 spelers, gebaseerd op Catan - Gezelschapsspel - Familiespel - Klein cadeautje", "url": "https://www.bol.com/nl/nl/p/catan-het-snelle-kaartspel-kaartspel/1004004011092718/" } ], "total": 165, "url": "https://www.bol.com/nl/nl/s/?searchtext=catan" } ```