GET /catalog/v4/products

The products operation gets detailed information for products.

Request URL structure:

https://api.bol.com/catalog/v4/products/{productId}

Request HTTP method:

GET

Request requires session:

No

Parameters:

Name Location Data type Required Description

productid

Path

Number

Yes

The unique id for one or more products (comma separated).

includeattributes

Query

Text

No

Return the full set of attributes for the products as key-value pairs. Note that by using the key-value pairs, more attributes are available as key-value pair than as elements.

– “true”: return key-value pair attributes
– “false”: return no key-value pair attributes

offers

Query

Text

No

all, cheapest, secondhand, newoffers, bolcom – default: bestoffer. The parameters can be combined using a comma, for instance offers=cheapest,secondhand returns the cheapest 2nd hand offer. Note that bestoffer returns only the best offer, making further filtering pointless

format Query Text No json (default): the response is returned in JSON. xml: the response is returned in XML
country Query Text No Signifies whether the shopping context is Dutch (NL; default) or Belgium (BE). This can influence search ranking, and whether some products and offers are returned

 

Response:

Element

Min

Max

Description

Product

1

1

The complete information of a product.

Request / Response example:

Request: https://api.bol.com/catalog/v4/products/1004004011187773?apikey={apikey}&offers=cheapest&includeAttributes=false&format=json

Example response: JSONXML