Advertising API

Country and Device
Insights into dimensions per country and device

New version of the Bulk Performance Reports endpoints There will be a new version of the advertising Bulk Performance Reports endpoints

Branded Shelves API connection Advertising performance reports for Branded Shelves will also be available through the advertising API

Expose out of daily budget timestamps
Additional insights on their (daily) budgets, more specifically, out of budget timestamps enabling further optimizing of campaigns.

Assortment
To retrieve a list of all the products in your inventory that are currently available for advertising.

Manager Accounts
Manager accounts that can access more than one advertiser. This will help Agencies or Retailers managing more than one advertiser.

Suggested keywords
Provide suggested keywords for manual campaigns.

Campaign Goals
Support advertisers in setting/defining campaign goals metadata

Linking campaigns to account budgets Allow advertisers to establish a link between campaigns and account budgets; while allowing multiple budgets to be active at the same time. This will enable advertisers with advanced budget management.

Launched in 2025

Share of voice report
Detailed insights on brand visibility and impression share.

PDP Performance report
PDP Performance Report, providing detailed insights into product visibility and engagement metrics on Product Detail Pages.

Ad delivery state
Expose information to indicate what ads are not running and why.

Launched in 2024

TACOS as a metric
Provide Total Advertising Cost of Sale. TACOS can help you understand how much you’re spending on advertising compared to the revenue generated.

Retrieve free credit balance
Enables advertisers to retrieve (remaining) free credit balance (if applicable).

Click Share as metric
A new metric that reveals your share of total clicks, enhancing your understanding of ad performance when combined with Impression Share.

Product Detail Pages - Manual Category Targeting
For manual campaigns - In Product Detail Pages (Product Targeting) add ability to target ads to certain categories​ as well as create different bids per category.

Split direct & indirect conversions
Updated entity-metrics and performance endpoints will provide detailed metrics for both direct and indirect conversions over a 14-day period.

Multiple Billing Parties
Enables advertisers to retrieve the identifiers of billing parties (such as agencies) associated with their accounts. This functionality will allow advertisers to allocate account budgets to these designated billing parties.

Product Categories (Retailer API - Available to Advertisers)
Get the full bol category tree, including category ID and category name, along with their hierarchical relationships.

Attribution Report
Insights into conversions, organic and sponsored sales for a comprehensive analysis of your campaign(s).

Bidding Report
Detailed metrics including auctions won, impression share and average winning bid for comprehensive campaign performance analysis.

Average winning bid for search-term
Insights to guide advertisers in setting optimal starting bids for search terms.

Average winning bid for categories
Insights to guide advertisers in setting optimal starting bids for categories.

New Advertising API
The new Advertising API are available (and required) for advertisers that have been migrated to the new sponsored products environment, starting with Early Adopters on 18 April 2024.

Product rankings and impressions
Retrieves the rank and impressions of products within the webshop, utilizing advanced models to analyze their performance in both search and browse contexts, offering a comprehensive technical overview of market positioning and visibility.