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.
Please note: The conversion might take some seconds the first time, but it will be cached, and any further requests will be fast.
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.
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.
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&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>
|