Coolblue Search
Search Coolblue with a product keyword. Region defaults to Belgium. Also use nl or de. Page through product cards.
Credit cost: 1 credit per call
ApiKeyAuthx-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringSearch words, or a Coolblue listing link.
Words:
sony wh-1000xm5Listing link:
https://www.coolblue.be/nl/zoeken?query=sony%20wh-1000xm5A product link is rejected.
page?numberPage number, from 1.
Belgium and the Netherlands send pagina. Germany sends Seite. Belgium in French sends page.
Examples:
12region?stringShop, when query is words rather than a full link.
- be: Belgium, Dutch (default). Example: koptelefoon
- nl: Netherlands. Example: koptelefoon
- de: Germany. Example: kopfhorer
- be-fr: Belgium, French. Example: casque
be-en, nl-en, and de-en open the English pages. A full Coolblue link picks the shop from the address.
fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
falseSuccessful response
application/json- response
results?array<>pagination?curl -X GET 'https://api.piloterr.com/v2/coolblue/search?query=string'{ "results": [ { "sku": "898247", "url": "https://www.coolblue.be/nl/product/898247/bluebuilt-usb-c-naar-usb-c-kabel-1-5m-kevlar-zwart.html", "name": "BlueBuilt Usb C naar Usb C kabel 1,5m Kevlar Zwart", "price": 29.99, "images": [ "https://image.coolblue.be/transparent/max/320xauto/products/2057932", "https://image.coolblue.be/500x500/products/2057932", "https://image.coolblue.be/480x360/products/2057932", "https://image.coolblue.be/512x288/products/2057932" ], "rating": 8.7, "region": "be", "currency": "EUR", "language": "nl", "image_url": "https://image.coolblue.be/transparent/max/320xauto/products/2057932", "highlights": [ "Onze keuze voor een extra stevige kabel voor je smartphone", "Kabellengte 1,5 m", "Kevlar", "100 W vermogen" ], "product_id": "898247", "availability": "in_stock", "pickup_label": "Nog sneller op te halen in 11 Coolblue-winkels", "review_count": 25, "price_display": "29,99 €" } ], "pagination": { "next": "https://www.coolblue.be/nl/kabels/oplaadkabels/usb-c-kabels/usb-c-naar-usb-c-kabels?pagina=2", "page": 1, "per_page": 22, "total_pages": 2, "total_results": null }}