API v2 – Getting Started

You have decided that you want to connect your system to bol.com. Great! On this page we will try to help you getting started.

First of all, make sure you have a Bol.com seller accountYou cannot connect to us without it.

Not a plug-and-play solution.

Please keep in mind that we do NOT offer a plug-and-play solution. There are several ways to connect your system to ours but all require knowledge of software development and programming.

There are, however, several third party plug-and-play solutions on the market which can be purchased or used on a subscription basis. We have listed a few of them on the website for sellers.

Three major data flows

When connecting to bol.com it is important to know that we define three major dataflows:

You can connect to 1, 2 or all of them. All of these also have their WYSIWYG counterparts on your bol.com seller dashboard.

Two major technologies

There are two very different ways to connect with us:

  • API
  • FTPS

The API connection is the preferred way to connect to us and will also provide you with the most detailed and fastest feedback. It has also the fastest processing time as compared to FTPS. An API connection is available for:

FTPS is used for slow bulk updates and is available for:


Whether you use the API or FTPS, you will need to identify yourself while connecting.

When using the API you use your API keys to create your authentication headers which you need to connect.

When using FTPS you will need to get an account on our servers for either Offer FTPS or Content FTPS separately.


When you are done building your first bol.com connection you can test it to see if it works. We have a very limited testing environment for the API where you can test whether your API requests are correct and your authentication is successful.

We recommend you to put your shop offline while making your first connection to the production environment. This will enable you to test your API calls and add products without them being shown on the website and thereby preventing them from being ordered.