--- type: "firecrawl-provider" description: "Coolblue (coolblue.nl, Dutch) public storefront for consumer electronics and appliances: keyword search with prices, ratings and delivery promises, and product details with specifications, pros and cons. Prices in EUR." use_when: "Coolblue (coolblue.nl, Dutch) public storefront for consumer electronics and appliances: keyword search with prices, ratings and delivery promises, and product details with specifications, pros and cons. Prices in EUR." categories: "Retail" capabilities: 2 credits_per_call: 5 --- # Coolblue Netherlands on Firecrawl Alexandria Coolblue (coolblue.nl, Dutch) public storefront for consumer electronics and appliances: keyword search with prices, ratings and delivery promises, and product details with specifications, pros and cons. Prices in EUR. - Categories: Retail - Category index: [Retail category](https://firecrawl.dev/alexandria/agents/categories/retail) - Provider key: `coolblue-nl` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/coolblue-nl) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/coolblue-nl/openapi.json) ## Capabilities - [Product](https://firecrawl.dev/alexandria/agents/providers/coolblue-nl/products/product): Get a Coolblue.nl product by product number or URL: name, brand, EUR price and list price, stock state and delivery promise, rating (1-10) and review count, key specs, the full specification table, EAN when published, and pros and cons when published. - [Search](https://firecrawl.dev/alexandria/agents/providers/coolblue-nl/products/search): Search Coolblue.nl by keyword and return one page of products: product id, name, EUR price and list price, rating (1-10) and review count, stock state, delivery text and URL, plus the input for the next page. Curated keywords that Coolblue redirects to a category return that category's listing. ## 1. Choose this provider when Coolblue (coolblue.nl, Dutch) public storefront for consumer electronics and appliances: keyword search with prices, ratings and delivery promises, and product details with specifications, pros and cons. 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": "coolblue-nl", "capability": "products/product", "options": { "product_id": 949371 } } ``` ## 3. Add provider options Use only the options needed for the task: - `product_id` (number): Coolblue product number (Artikelnummer), the number after /product/ in its URL. Example: `10` - `url` (string): HTTPS coolblue.nl product URL. Supply this or product_id. Pattern: ^https://(?:www\.)?coolblue\.nl/(?:en/)?product/[0-9]+(?:[/?#]|$). Example: `` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "coolblue-nl", capability: "products/product", options: { product_id: 949371, }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "coolblue-nl", "capability": "products/product", "options": { "product_id": 949371 } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "coolblue-nl", "capability": "products/product", "options": { "product_id": 949371 } } }' ``` ### CLI ```sh firecrawl scrape 'coolblue-nl/products/product' \ --options '{"product_id":949371}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "coolblue-nl", "capability": "products/product", "options": { "product_id": 949371 } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "coolblue-nl", "capability": "products/product", "options": { "product_id": 949371 } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "brand": "BlueBuilt", "cons": [ "De kabel werkt alleen vanuit een usb C aansluiting op je laptop of desktop naar DisplayPort, en niet van een DisplayPort poort op je pc naar usb C." ], "country": "NL", "currency": "EUR", "delivery_promise": "Op voorraad", "description": "Met deze BlueBuilt USB-C naar DisplayPort Kabel 2m sluit je gemakkelijk jouw laptop of pc met usb C ingang aan op de DisplayPort ingang van je monitor of televisie. Met een DisplayPort kabel verzend je beelden en geluiden van hogere kwaliteit dan met een usb kabel. Dit maakt deze kabel bijvoorbeeld geschikt voor gaming. Door de kabellengte van 2 meter heb je hier ook genoeg ruimte voor. De DisplayPort heeft een 1.4 connector, waardoor hij genoeg bandbreedte heeft voor een 4K ultra HD stream tot 120 hertz. Bij dit BlueBuilt product krijg je 5 jaar garantie.", "ean": null, "image_url": "https://image.coolblue.nl/500x500/products/2119487", "in_stock": true, "key_specs": [ "Usb C (male)", "DisplayPort (male)", "Kabellengte 2 meter" ], "list_price": null, "manufacturer_code": "BBUDC24", "name": "BlueBuilt USB-C naar DisplayPort Kabel 2m", "observed_at_ms": 1792807593000, "price": 30.99, "product_id": 949371, "product_type": "kabel converter", "pros": [ "Sluit je laptop of pc met usb C ingang aan op een DisplayPort ingang op jouw monitor of televisie.", "Door de kabellengte van 2 meter heb je genoeg ruimte tussen je apparaten.", "Bij dit BlueBuilt product krijg je 5 jaar garantie." ], "rating": 9.3, "review_count": 3, "specifications": [ { "group": "Product", "specs": [ { "name": "Artikelnummer", "value": "949371" }, { "name": "Fabrikantcode", "value": "BBUDC24" }, { "name": "Merk", "value": "BlueBuilt" }, { "name": "Afhandeling van je defect", "value": "Via Coolblue" }, { "name": "Oude apparaat gratis retour", "value": "true" } ] }, { "group": "Connectiviteit", "specs": [ { "name": "Usb-aansluiting", "value": "true" }, { "name": "Type usb-aansluiting", "value": "Usb-C" }, { "name": "Lightning aansluiting", "value": "false" }, { "name": "HDMI-aansluiting", "value": "false" }, { "name": "DisplayPort-aansluiting", "value": "true" }, { "name": "Type DisplayPort aansluiting", "value": "standaard DisplayPort" }, { "name": "Soort standaard DisplayPort aansluiting", "value": "Connector/male" }, { "name": "DVI-aansluiting", "value": "false" }, { "name": "VGA-aansluiting", "value": "false" }, { "name": "Hoofdtelefoon aansluiting", "value": "false" }, { "name": "Netwerkaansluiting", "value": "false" } ] }, { "group": "Fysieke eigenschappen", "specs": [ { "name": "Kleur", "value": "Zwart" }, { "name": "Gevlochten huls", "value": "false" }, { "name": "Kabellengte", "value": "2 m" } ] } ], "stock_status": "OnStock", "url": "https://www.coolblue.nl/product/949371/bluebuilt-usb-c-naar-displayport-kabel-2m.html" } ``` ## 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 a Coolblue.nl product by product number or URL: name, brand, EUR price and list price, stock state and delivery promise, rating (1-10) and review count, key specs, the full specification table, EAN when published, and pros and cons when published. - Instructions: Get a Coolblue.nl product by product number or URL: name, brand, EUR price and list price, stock state and delivery promise, rating (1-10) and review count, key specs, the full specification table, EAN when published, and pros and cons when published. - Cost: 5 credits per call - Capability file: [Product](https://firecrawl.dev/alexandria/agents/providers/coolblue-nl/products/product) Accepted options: - `product_id` (number): Coolblue product number (Artikelnummer), the number after /product/ in its URL. Example: `10` - `url` (string): HTTPS coolblue.nl product URL. Supply this or product_id. Pattern: ^https://(?:www\.)?coolblue\.nl/(?:en/)?product/[0-9]+(?:[/?#]|$). Example: `` Response schema example: ```json { "brand": "BlueBuilt", "cons": [ "De kabel werkt alleen vanuit een usb C aansluiting op je laptop of desktop naar DisplayPort, en niet van een DisplayPort poort op je pc naar usb C." ], "country": "NL", "currency": "EUR", "delivery_promise": "Op voorraad", "description": "Met deze BlueBuilt USB-C naar DisplayPort Kabel 2m sluit je gemakkelijk jouw laptop of pc met usb C ingang aan op de DisplayPort ingang van je monitor of televisie. Met een DisplayPort kabel verzend je beelden en geluiden van hogere kwaliteit dan met een usb kabel. Dit maakt deze kabel bijvoorbeeld geschikt voor gaming. Door de kabellengte van 2 meter heb je hier ook genoeg ruimte voor. De DisplayPort heeft een 1.4 connector, waardoor hij genoeg bandbreedte heeft voor een 4K ultra HD stream tot 120 hertz. Bij dit BlueBuilt product krijg je 5 jaar garantie.", "ean": null, "image_url": "https://image.coolblue.nl/500x500/products/2119487", "in_stock": true, "key_specs": [ "Usb C (male)", "DisplayPort (male)", "Kabellengte 2 meter" ], "list_price": null, "manufacturer_code": "BBUDC24", "name": "BlueBuilt USB-C naar DisplayPort Kabel 2m", "observed_at_ms": 1792807593000, "price": 30.99, "product_id": 949371, "product_type": "kabel converter", "pros": [ "Sluit je laptop of pc met usb C ingang aan op een DisplayPort ingang op jouw monitor of televisie.", "Door de kabellengte van 2 meter heb je genoeg ruimte tussen je apparaten.", "Bij dit BlueBuilt product krijg je 5 jaar garantie." ], "rating": 9.3, "review_count": 3, "specifications": [ { "group": "Product", "specs": [ { "name": "Artikelnummer", "value": "949371" }, { "name": "Fabrikantcode", "value": "BBUDC24" }, { "name": "Merk", "value": "BlueBuilt" }, { "name": "Afhandeling van je defect", "value": "Via Coolblue" }, { "name": "Oude apparaat gratis retour", "value": "true" } ] }, { "group": "Connectiviteit", "specs": [ { "name": "Usb-aansluiting", "value": "true" }, { "name": "Type usb-aansluiting", "value": "Usb-C" }, { "name": "Lightning aansluiting", "value": "false" }, { "name": "HDMI-aansluiting", "value": "false" }, { "name": "DisplayPort-aansluiting", "value": "true" }, { "name": "Type DisplayPort aansluiting", "value": "standaard DisplayPort" }, { "name": "Soort standaard DisplayPort aansluiting", "value": "Connector/male" }, { "name": "DVI-aansluiting", "value": "false" }, { "name": "VGA-aansluiting", "value": "false" }, { "name": "Hoofdtelefoon aansluiting", "value": "false" }, { "name": "Netwerkaansluiting", "value": "false" } ] }, { "group": "Fysieke eigenschappen", "specs": [ { "name": "Kleur", "value": "Zwart" }, { "name": "Gevlochten huls", "value": "false" }, { "name": "Kabellengte", "value": "2 m" } ] } ], "stock_status": "OnStock", "url": "https://www.coolblue.nl/product/949371/bluebuilt-usb-c-naar-displayport-kabel-2m.html" } ``` ### Search - Capability: `products/search` - Description: Search Coolblue.nl by keyword and return one page of products: product id, name, EUR price and list price, rating (1-10) and review count, stock state, delivery text and URL, plus the input for the next page. Curated keywords that Coolblue redirects to a category return that category's listing. - Instructions: Find Coolblue products and their product_id for product. - Cost: 5 credits per call - Capability file: [Search](https://firecrawl.dev/alexandria/agents/providers/coolblue-nl/products/search) Accepted options: - `page` (number): page Example: `1` - `query` (string, required): Search keywords, as typed in the Coolblue search box (Dutch or brand/model terms). Example: `` Response schema example: ```json { "count": 5, "country": "NL", "currency": "EUR", "has_more": true, "next_page_input": { "page": 2, "query": "iphone" }, "observed_at_ms": 1792807593000, "page": 1, "query": "iphone", "redirected_to": "/mobiele-telefoons/smartphones/apple-iphone", "results": [ { "delivery_promise": "Op voorraad", "image_url": "https://image.coolblue.nl/500x500/products/2213003", "list_price": null, "name": "Apple iPhone 17 Pro 256GB Blauw", "price": 1239, "product_id": 969443, "rating": 9.1, "review_count": 64, "stock_status": "OnStock", "url": "https://www.coolblue.nl/product/969443/apple-iphone-17-pro-256gb-blauw.html" }, { "delivery_promise": "Op voorraad", "image_url": "https://image.coolblue.nl/500x500/products/1395171669", "list_price": null, "name": "Apple iPhone 18 Pro 256GB Bordeaux Rood", "price": 1479, "product_id": 986133, "rating": 9.1, "review_count": 6, "stock_status": "OnStock", "url": "https://www.coolblue.nl/product/986133/apple-iphone-18-pro-256gb-bordeaux-rood.html" }, { "delivery_promise": "Op voorraad", "image_url": "https://image.coolblue.nl/500x500/products/1366838204", "list_price": null, "name": "Apple iPhone 18 Pro Max 256GB Lichtblauw", "price": 1629, "product_id": 986147, "rating": 9.2, "review_count": 19, "stock_status": "OnStock", "url": "https://www.coolblue.nl/product/986147/apple-iphone-18-pro-max-256gb-lichtblauw.html" }, { "delivery_promise": "Op voorraad", "image_url": "https://image.coolblue.nl/500x500/products/2141650", "list_price": null, "name": "Apple iPhone 16e 128GB Zwart", "price": 699, "product_id": 960308, "rating": 8.8, "review_count": 43, "stock_status": "OnStock", "url": "https://www.coolblue.nl/product/960308/apple-iphone-16e-128gb-zwart.html" }, { "delivery_promise": "Op voorraad", "image_url": "https://image.coolblue.nl/500x500/products/2212872", "list_price": null, "name": "Apple iPhone 17 Pro 256GB Oranje", "price": 1239, "product_id": 968965, "rating": 9.1, "review_count": 64, "stock_status": "OnStock", "url": "https://www.coolblue.nl/product/968965/apple-iphone-17-pro-256gb-oranje.html" } ], "total_pages": 5, "url": "https://www.coolblue.nl/mobiele-telefoons/smartphones/apple-iphone/filter" } ```