Media Service

You will get a link to any attached assets from the product information fetched. You may add GET parameters to manipulate what the asset should be converted to.

The following transformation parameters can be used to retrieve manipulated image content.

Auto Gamma

Query Params: ag
Example: ag

Auto Level

Query Params: al
Example: al

Crop

Query Params: cw:width, ch:height, cx:x offset, cy=y offset
Example: cw=100&ch100&cx=10&cy=10
Remarks: At least cw is required to activate cropping.

File Format

Query Params: f
Example: f=jpg
Remarks: The format of the picture transformation result. Possible values jpg, png, gif, webp. Default format jpg. 

Imagga Smart Crop

Query Params: scw: width, sch: height
Example: scw=100&sch=100
Remarks: Both scw and sch are required to activate smart cropping. Read more about smart cropping.

Resize

Query Params: w: width, h: height
Example: w=100
Remarks: At least one of two must be specified to activate any resizing. This will upscale the image if the original is smaller than the defined resize dimension, and it will not change the image ratio.

Set up custom subdomains

In 2024, as part of a broader initiative to enhance online privacy and security, major web browsers are discontinuing support for cross-domain cookies. This significant change is designed to address privacy concerns and offer a more transparent, secure web browsing experience. As a result, advertisers and website operators are shifting towards privacy-friendly alternatives.

If you use media from Bluestone PIM's media bank for your website. We fully support this. When you use media from our media bank, we serve it via CloudFront. This ensures quick loading times and efficient media delivery to your site.

To maintain this efficiency and independence from the bluestonepim.com domain, we advise creating a custom subdomain for each channel that uses media from media.bluestonepim.com.

Create a ticket at Servicedesk, for help with setting up a custom asset domain.

The Bluestone PIM API will always return media.bluestonepim.com URL as domain for all media. The structure is the following:

Example: 

Developers on external websites can then replace the first part of the URL (Base URL) with the enabled custom domain like below, and the media will then be served from their own domain: