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 Q3 of 2023 we will no longer be able to support the Open API fully. All endpoints have become general available on April 1st in Retailer API v9. For you, it’s beneficial to switch over to Retailer API before July 1st 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.