Piloterr

Coolblue Product

GET
/v2/coolblue/product

Read one Coolblue product by article id or product URL, in the region of that shop.

Credit cost: 1 credit per call

Authorization

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Query Parameters

query*string

Product link, or the article number.

Link:

https://www.coolblue.be/nl/product/905648/sony-wh-1000xm5-zwart.html

Article number:

905648

Use region nl, de, or be-fr to open that number on another shop. A search link is rejected.

region?string

Shop for a bare article number.

  • be: Belgium, Dutch (default). Example: 905648
  • nl: Netherlands
  • de: Germany
  • be-fr: Belgium, French

be-en, nl-en, and de-en open the English pages. A full product link picks the shop from the address.

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Response Body

Successful response

application/json
  1. response
sku?string
url?string
cons?array<>
name?string
pros?array<>
brand?string
price?integer
images?array<string>
rating?number
region?string
currency?string
language?string
condition?string
image_url?string
in_the_box?array<string>
product_id?string
breadcrumbs?array<string>
description?string
availability?string
review_count?integer
included_note?string
price_display?string
specifications?array<>
manufacturer_code?string
availability_label?string
Example Request
curl -X GET 'https://api.piloterr.com/v2/coolblue/product?query=string'
Example Response
{  "sku": "905648",  "url": "https://www.coolblue.be/nl/product/905648/sony-wh-1000xm5-zwart.html",  "cons": [    {      "text": "Je vouwt de koptelefoon niet compact op.",      "title": null    }  ],  "name": "Sony WH-1000XM5 Zwart",  "pros": [    {      "text": "Dankzij de topklasse noise cancelling wordt omgevingsgeluid sterk gedempt.",      "title": null    },    {      "text": "Met de Sony Headphones Connect app personaliseer je het geluid via een equalizer.",      "title": null    },    {      "text": "Dankzij de snellaadfunctie gebruik je na 3 minuten opladen de koptelefoon voor 3 uur.",      "title": null    }  ],  "brand": "Sony",  "price": 249,  "images": [    "https://image.coolblue.nl/500x500/products/1755757",    "https://image.coolblue.nl/480x360/products/1755757",    "https://image.coolblue.nl/512x288/products/1755757"  ],  "rating": 8.8,  "region": "be",  "currency": "EUR",  "language": "nl",  "condition": "new",  "image_url": "https://image.coolblue.nl/500x500/products/1755757",  "in_the_box": [    "Handleiding ( 3.02 MB)",    "Opberghoes (hardcase)",    "Usb C naar usb A oplaadkabel (exclusief oplader)",    "Audiokabel"  ],  "product_id": "905648",  "breadcrumbs": [    "Portable audio",    "Koptelefoons",    "Sony koptelefoons",    "Sony WH koptelefoons"  ],  "description": "De Sony WH-1000XM5 Zwart is een draadloze koptelefoon met topklasse noise cancelling. Dankzij de 2 noise cancelling processors dempt de koptelefoon omgevingsgeluid zeer precies. Zo heb je minder last van je omgeving en zet je het volume van de muziek niet onnodig hard. In de Sony Headphones Connect app personaliseer je de geluidsweergave via een equalizer. Hierdoor voeg je een accent toe aan de lage tonen en luister je naar het geluid dat jij mooi vindt. Op een volle lading gaat de koptelefoon 30 uur mee. Is de batterij leeg? Na 3 minuten opladen gebruik je de koptelefoon voor 3 uur.",  "availability": "in_stock",  "review_count": 404,  "included_note": "Geen oplader meegeleverd",  "price_display": "249,00 €",  "specifications": [    {      "name": "Artikelnummer",      "group": "Product",      "value": "905648"    },    {      "name": "Fabrikantcode",      "group": "Product",      "value": "WH1000XM5B.CE7"    },    {      "name": "Merk",      "group": "Product",      "value": "Sony"    },    {      "name": "Garantie",      "group": "Product",      "value": "2 jaar"    },    {      "name": "Noise cancelling",      "group": "Geluid",      "value": "Ja"    },    {      "name": "Kwaliteit noise cancelling",      "group": "Geluid",      "value": "Topklasse"    },    {      "name": "Bluetooth-versie",      "group": "Verbinding",      "value": "5.2"    },    {      "name": "Type oorkussen",      "group": "Behuizing",      "value": "Over ear"    }  ],  "manufacturer_code": "WH1000XM5B.CE7",  "availability_label": "Morgen geleverd"}