Media service

You will get a link to any assets assigned to the product when fetching product information. You may add GET parameters to manipulate what the asset should be converted to.

Please note: The conversion might take some seconds the first time, but it will be cached, thus any further requests will be fast.


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



Auto gamma

Query param: ag
Example:
ag



Auto level

Query param: 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 param: 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.



Trim

Query param: trim
Example:
trim&trim-fuzz=0.12
Remarks: 
Makes a ‘best guess’ crop to upper-left and lower-right corners. For example, if you have an image with a white border around it, and you want that area to be removed.

Optional:
trim-fuzz: Use 'trim-fuzz' in addition to fuzz the trimming edge. For JPEGs, due to compression or anti-aliasing, edges are often not clean. The fuzz value allows you to trim with a slight extra fuzz around the trim area. Valid values are 0.0 - 1.0 (default 0.0).



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.

Please note: Utilizing media from our media bank counts towards your monthly data transfer quota, as outlined in your agreement. Exceeding this limit will incur additional charges based on the terms of your contract.

It is recommended to optimize the use of images so that they are not downloaded to clients larger than necessary, by using the transformation parameters available in the media service.


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

https://media.bluestonepim.com/<ORG.ID>/<PID>/<FILENAME>?<PARAMETERS>

Example: 

https://media.bluestonepim.com/086c29d6-8145404-435-81f4-45/hj-c8fd-4c8e-a62d-a270ccdf9307/hjh/v2qJFRLbhnRqrJZGOZOW56TM6.jpg?f=webp&amp;w=350"

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:

https://cdn.customer.com/<ORG.ID>/<PID>/<FILENAME>?<PARAMETERS>

 

 

Back to the top