Whatagraph supports two separate bol.com integrations: one for retailer (sales) data and one for advertising data. They connect independently and use separate credentials. If your client sells and advertises on bol.com, you'll need both.
Bol.com Retailer
Use this integration to report on sales activity: orders, shipments, returns, and revenue.
How to connect
You'll need a Client ID and Client Secret with retailer API access. These are generated in the bol.com developer portal under your retailer account. Once entered in Whatagraph, the connection is verified automatically.
Important: Advertiser-only credentials will not work for this integration. Make sure the credentials have retailer API access enabled.
What data is available
Data | What it includes |
Orders | Order IDs and timestamps for all order statuses and fulfilment methods |
Order items | Unit price, total price, commission, quantity shipped and cancelled, product name and EAN, fulfilment method (FBB or FBR), discounts |
Shipments | Shipment records split by Fulfilled by Bol (FBB) and Fulfilled by Retailer (FBR) |
Returns | Return records split by FBB and FBR, including return reasons and customer comments |
Things to be aware of
Historical data is limited to the last 90 days. This is a limitation of bol.com's API and applies to all tools connecting to bol.com, not just Whatagraph.
Revenue figures are calculated by Whatagraph from order item records (price × quantity). Bol.com's API does not provide a pre-aggregated revenue figure.
Bol.com Advertising
Use this integration to report on Sponsored Products ad performance: impressions, clicks, spend, conversions, ACoS, and more.
How to connect
You'll need a Client ID and Client Secret with advertiser API access. These are separate from retailer credentials — even if your client uses the same bol.com account for both, two separate connections are required.
Important: Retailer-only credentials will not work for this integration. Make sure the credentials have advertiser API access enabled.
What data is available
Performance data is available at six levels of breakdown:
Report level | What it shows |
Advertiser | Overall account performance |
Campaign | Performance broken down by campaign |
Ad group | Performance broken down by ad group within campaigns |
Ad | Performance per individual ad, including product EAN |
Keyword | Performance broken down by keyword |
Target category | Performance by targeted product category |
Target product | Performance by targeted competitor or related product |
Things to be aware of
This integration covers Sponsored Products only. Other ad formats are not available via bol.com's API.
Data is fetched via bol.com's bulk report system and refreshed nightly by 6 AM Amsterdam time (CET/CEST). Wider date ranges may take a little longer to load than other integrations.
Frequently asked questions
My client sells and advertises on bol.com. Do I need to connect both integrations?
Yes. Retailer (sales) data and Advertising data are separate connections with separate credentials. Add both if you want to report on both.
Can I use the same Client ID and Secret for both integrations?
Only if the credentials have both retailer and advertiser access enabled in bol.com. In most cases, they are separate. Check with your client if unsure.
Why can I only see 90 days of data in the Retailer integration?
This is a limitation of bol.com's API. It does not allow querying order data older than 90 days. This applies to all tools connecting to bol.com, not just Whatagraph.
I'm getting a credentials error when connecting. What should I check?
Make sure the credentials you're entering have the correct API access type: retailer access for the Retailer integration, advertiser access for the Advertising integration. Mixing them up is the most common cause of connection errors.