Welcome to the bol Partner API

The bol Partner API connects your systems to bol — whether you sell on the marketplace, supply product content, or advertise. This guide takes you from zero to your first API call, whichever kind of integrator you are.

Please read the Terms of Service before connecting.

Who integrates with bol

  • Retailers & intermediaries — third-party sellers on the bol marketplace, and intermediaries integrating on their behalf.

  • Suppliers — Companies supplying products directly to bol as a retailer.

  • Advertisers — partners running Sponsored Products campaigns.

Not sure which applies to you? See Choose your integration role.

Step 1. Choose how to integrate

You can build a custom integration directly against the Partner API, or use an existing third-party solution that connects to bol for you.

  • Build your own — follow this documentation to develop a custom integration. This requires software-development knowledge; bol does not offer a plug-and-play solution.

  • Use a third-party solution — several third-party integration partners offer ready-made connections to bol.

Step 2. Set up access

All integrators authenticate with OAuth2 against login.bol.com. Get the account and credentials for your role:

See Authentication for the full flow.

Step 3. Learn the essentials

These apply to every integration:

  • Key concepts — products, offers and orders (the bol data model)

  • Conventions — request/response standards, headers, pagination and error handling

  • Rate limiting — limits and the headers we return

  • Process status — most calls are asynchronous; confirm the result afterwards

Step 4. Test in the demo environment

Validate your implementation before going live:

  • Demo environment — hardcoded examples for every endpoint, with the same models and validation as production.

We also publish Postman collections and example demo scenarios per API — find them in the API quick reference (Postman and Demo columns). When using a Postman collection, update its environment with your own API credentials.

Step 5. Start building

Follow the path for your integrator type:

Retailers & intermediaries

Start with the Retailer overview, then build the selling workflow: Offers → Orders & Shipments → Product Content. The full set is under the Retailers section in the navigation menu.

Suppliers

Deliver and maintain product data: Supplier overview → Product Content → Products.

Advertisers

Create and optimise campaigns: Advertising overview → Campaigns → Reporting.

Reference & tools

  • API quick reference — every API’s documentation, Redoc, OpenAPI specs, Postman collections and release notes.

Best practices & tutorials

Service and legal