Open API endpoints available in Retailer API

We have developed new endpoints to transfer retailer relevant Open API functionalities to Retailer API. The reason for this is that by October 16, 2023, we will no longer be able to support the Open API for retailer partners. All endpoints have become general available on April 1st in Retailer API v9. For you, it’s beneficial to switch over to Retailer API as soon as possible to ensure stability and support.

About the endpoints

The following endpoints are available in Retailer API v9:

Competing offers

This endpoint enables you to retrieve all active offers for a product providing detailed information about the competitiveness of the offers. For more information, see the functional documentation and Redoc.

Retailer information

With this endpoint you can retrieve the customer ratings and reviews for a specific retailer. For more information, see the functional documentation and Redoc.

Product placement

This endpoint helps you retrieve the product categories and location of a specific product in the webshop. For more information, see the functional documentation and Redoc.

Product list

This functionality provides a list of products based on category, search term or filters that reflects the current ranking of a product within that list for the specified country on the webshop. For more information, see the functional documentation and Redoc.

Product list filters

This functionality provides the filter options and categories for a product on the bol.com webshop. It helps the customers refine their search results and find their desired product, based on a category or search term. For more information, see the functional documentation and Redoc.

Product rating

Product ratings indicate how consumers have rated a specific product thereby displaying aggregated reviews for your products. This functionality provides access to the product ratings provided by the consumers on the webshop. For more information, see the functional documentation and Redoc.

Product assets

Assets include all types of content such as images, videos, manuals or other supporting elements that can be added to a product. This endpoint enables you to retrieve detailed information about the image assets associated with a specific product. Product assets are vital for retailers to grow their businesses. For example, high quality images not only allow customers to make an informed decision but also improves brand loyalty and trust, leading to growth in sales. For more information, see the functional documentation and Redoc.

Get product id by EAN

This endpoint enables you to retrieve the bol.com Product ID and the EANs associated with a product. For more information, see the functional documentation and the Redoc.

Migration guide

We understand that migrating to a new API can be challenging, so we have created a migration guide to make the process as smooth as possible. The new endpoints are designed to align with the conventions and principles of Retailer API, and thus have a different setup compared to Open API. To assist you, we have included an endpoint mapping, object mapping, and an FAQ section to provide an overview of the key changes.

Questions or feedback

If you have any questions about the migration from the Open API to the Retailer API endpoints or feedback about the endpoints above, please send an email to: openapi-migratie@bol.com.