Product assets

Assets include all types of content such as images, videos, manuals or other supporting elements that can be added to a product.

This endpoint enables you to retrieve detailed information about the image assets associated with a specific product.

Product assets are vital for retailers to grow their businesses. For example, high quality images not only allow customers to make an informed decision but also improves brand loyalty and trust, leading to growth in sales.

This functionality only focuses on image assets of a product. For more information on the content of a product, see Catalog product content endpoint.

How can it help?

This endpoint helps you:

  • Gather all product images to gauge the content maturity.

  • Identify the order of the images in the carousel on the product detail page.

  • Integrate product images into the user interface for easy product identification and navigation.

  • Develop effective strategies to enrich the product for an optimized user experience.

Retrieving image assets for a product

Use the Get product assets endpoint to retrieve information about image assets of a product on the bol webshop.

To retrieve the image assets for a product:

  1. Specify the following in the request:

    • EAN of the product (mandatory).

    • usage (optional) - Specifies how an image is used on the product detail page. Provide any one of the following values:

      • PRIMARY - Returns the primary image of the product. This image is used as the main image and is displayed as the thumbnail of a product on the webshop.

      • ADDITIONAL - Returns all other images except the primary image of the product. These images are used to display a product from different angles or show intricate product details and texture.

      • IMAGE - Returns both primary and additional images.

  2. In the response, the endpoint provides you the following:

    • usage - Specifies the usage of an image asset. For example, PRIMARY or ADDITIONAL.

    • order - Specifies the location where an image is positioned in the carousel on the product detail page. The order of the primary image is set to 0.

    • variants - Specifies the options available for an image asset with different attributes. For example, an image with various sizes. It provides you the following details:

      • Size - Offers the following sizes:

        • small - 250 (width) x 200 (height) pixels.

        • medium - 550 (width) x 840 (height) pixels. The original image will get resized until it fits the canvas of 550 x 840 pixels maximum.

      • Width

      • Height

      • Media type

      • URL of the variant

Using these insights, you can enhance the quality of the images and improve customer experience. Use the Create content for a product endpoint to add the improved images to the product.

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