Retailer information

This functionality provides you comprehensive insights on your potential competitors. It helps you to dive into specific aspects of your competitors’ businesses.

For more information on how to identify the competitors of your product, see Competing Offers API.

How can it help?

A comprehensive retailer analysis can help:

  • Research about all identified competitors.

  • Analyze strengths and weaknesses of your competitors.

  • Spot opportunities to innovate, promote your business, enhance your products or services, and outshine your competition.

  • Support in strategic decision-making.

Get retailer information by retailer id

The Get retailer information by retailer id endpoint retrieves the customer ratings and reviews for a specific retailer within bol. Specify the retailerId received from the Get a list of competing offers by EAN endpoint in the request body to get the following useful insights:

  • Retailer name and ID.

  • Registration date.

  • The retailer is a top seller or not.

    Top retailers stand out and are recognized through a golden label on the webshop. For more information on the eligibility criteria of becoming a top retailer, see Gouden label bij goede beoordelingen section on the partner’s platform.

  • Customer ratings for a retailer derived from the following factors:

    • Service provided by the retailer in the last three months.

    • Product information provided by the retailer.

    • Time taken by the retailer to deliver the product.

    • Shipping details provided by the retailer.

  • Customer reviews for a retailer derived from the following factors:

    • Number of positive customer reviews.

    • Number of negative customer reviews.

    • Number of neutral customer reviews.

    • Percentage of customers that rated the retailer either neutral or positive during the rating method period.

    • Total amount of customer reviews during the rating method period.

A retailer account is valid only in one country.
By default, the retailerRating field is based on the ratings and reviews from the last three months. However, if sufficient data is not gathered in the last three months, then all available reviews are taken into consideration.

For more information on the request and response body of this endpoint, see Redoc.