Tuned Global

This API provides READ access to public information about artists, albums, playlists, stations, tags and more.

Tuned Global Metadata aAPIs

Authentication

API Key Authentication

Basic HTTP Authentication

HMAC Authentication

Catalogue

Release

Livevideo

Author

Content Control

Podcast

Track

Song

Audiobook

Artist

Album

Grouped Catalogue

Station

ShadowQueue

Playlist

Content Pages and Carousel

Page

Content

Settings

Group

Search

Audiobooks

Live Shows

Podcasts

Tags and Users

Other

Getbyname

Getmultiplebyname

Getartistsbytag

Retrieve podcast channel that have been assigned to this tag

Getpodcastchannelbytag

Getalbumsbytag

Getstationsbytag

Retrieve Audiobooks that have been assigned to this tag

Getaudiobooksbytag

Getalbumsbytaggroups

Getartistsbytaggroups

Gettagsbytagtype

GetPlaylistsByTag

GetPlaylistsByTags

User

Get User Public Profile by user Id. <strong>Note:</strong> A user must have their allow public as active

Getprofilebyid

Retrieve a list of profiles (ids) the given public user is following.

Getfollowing

Get User Public Profile by username. <strong>Note:</strong> A user must have their allow public as active

Getprofilebyusername

Check if email exists in third party systems. <strong> Note: </strong> This API is only available if 3rd party authentication systems are used and this feature is available.  
            It is not available by default.

Externalemailexists

Image Engine

Tools

API Explorer

Default

Metadata

Production

<p class="slate-p " >Tuned Global Advanced APIs (aAPIs) consist of a group of Metadata, Services and Authentication APIs.</p><p class="slate-p " >These Metadata APIs are used where user context is not required, the Services APIs are where user context is required.  This means that the security models are different between Metadata and Services APIs.</p><p class="slate-p " ></p><div style="width:100%;
	min-width:100%;" class="callout-widget" data-type=error ><div class="callout-icon"><svg width="18" height="18" viewBox="0 0 18 18" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M9.08366 9.9801C9.25033 9.9801 9.39269 9.92107 9.51074 9.80302C9.6288 9.68496 9.68783 9.53566 9.68783 9.3551V5.31344C9.68783 5.14677 9.62533 5.00441 9.50033 4.88635C9.37533 4.7683 9.22949 4.70927 9.06283 4.70927C8.88227 4.70927 8.73296 4.7683 8.61491 4.88635C8.49685 5.00441 8.43783 5.15371 8.43783 5.33427V9.37594C8.43783 9.5426 8.50033 9.68496 8.62533 9.80302C8.75033 9.92107 8.9031 9.9801 9.08366 9.9801ZM9.00033 13.1676C9.19477 13.1676 9.35796 13.1016 9.48991 12.9697C9.62185 12.8377 9.68783 12.6745 9.68783 12.4801C9.68783 12.2857 9.62185 12.1225 9.48991 11.9905C9.35796 11.8586 9.19477 11.7926 9.00033 11.7926C8.80588 11.7926 8.64269 11.8586 8.51074 11.9905C8.3788 12.1225 8.31283 12.2857 8.31283 12.4801C8.31283 12.6745 8.3788 12.8377 8.51074 12.9697C8.64269 13.1016 8.80588 13.1676 9.00033 13.1676ZM9.00033 17.3343C7.81977 17.3343 6.72255 17.1225 5.70866 16.6989C4.69477 16.2752 3.81283 15.6884 3.06283 14.9384C2.31283 14.1884 1.72602 13.3065 1.30241 12.2926C0.878798 11.2787 0.666992 10.1815 0.666992 9.00094C0.666992 7.83427 0.878798 6.74399 1.30241 5.7301C1.72602 4.71621 2.31283 3.83427 3.06283 3.08427C3.81283 2.33427 4.69477 1.74399 5.70866 1.31344C6.72255 0.88288 7.81977 0.667603 9.00033 0.667603C10.167 0.667603 11.2573 0.88288 12.2712 1.31344C13.285 1.74399 14.167 2.33427 14.917 3.08427C15.667 3.83427 16.2573 4.71621 16.6878 5.7301C17.1184 6.74399 17.3337 7.83427 17.3337 9.00094C17.3337 10.1815 17.1184 11.2787 16.6878 12.2926C16.2573 13.3065 15.667 14.1884 14.917 14.9384C14.167 15.6884 13.285 16.2752 12.2712 16.6989C11.2573 17.1225 10.167 17.3343 9.00033 17.3343ZM9.00033 16.0843C10.9448 16.0843 12.6114 15.3898 14.0003 14.0009C15.3892 12.612 16.0837 10.9454 16.0837 9.00094C16.0837 7.05649 15.3892 5.38982 14.0003 4.00094C12.6114 2.61205 10.9448 1.9176 9.00033 1.9176C7.05588 1.9176 5.38921 2.61205 4.00033 4.00094C2.61144 5.38982 1.91699 7.05649 1.91699 9.00094C1.91699 10.9454 2.61144 12.6989 4.00033 14.0009C5.38921 15.3898 7.05588 16.0843 9.00033 16.0843Z" fill="#E90005"></path></svg></div><div ><p class="slate-p " >Unless explicitly stated in either your direct licensor agreements or your Tuned Global agreements, Tuned Global content, being either the assets or metadata, cannot be used to train Machine Learning or AI models.</p></div></div><h3 class="slate-h3 " >Usage</h3><p class="slate-p " >The Metadata APIs provided READ access to public information about artists, albums, playlists, stations, videos, podcasts, tags and more.  This group of APIs provides the ability to search your catalogue.</p><p class="slate-p " >General usage of the APIs would be as follows;</p><ol class="slate-ol " ><li class="slate-li " ><div style="position:relative">Understand the security models assigned to different APIs. Refer to the Authentication Section for more information.</div></li><li class="slate-li " ><div style="position:relative">If you are initially building a general access view, where user context is not required, use these metadata APIs as the recommended first step in development</div></li><li class="slate-li " ><div style="position:relative">Use the Services APIs to access contextual information, usually involving the catalogue and the user</div></li><li class="slate-li " ><div style="position:relative">If you need access to alternate environments, these will need to be added to your MSA (Development)</div></li></ol><h3 class="slate-h3 " >Use Cases</h3><p class="slate-p " >The suite of Advanced APIs provide a wide range of tools to get the output you are looking for in regards to your project.  Our team and systems are used in many different use cases, ranging from traditional streaming, metadata usage, background music services, airlines, gaming and web3 experiences to name a few.  Contact our team with you specific use case if you are unsure and we will provide details of the APIs that will provide the results you are looking for.</p><h3 class="slate-h3 " >CMS - AutoTune</h3><p class="slate-p " >There are many of the metadata APIs that provide output that you have defined via the AutoTuned CMS.  Instructions on AutoTune CMS are not part of this API documentation but are available via credentials you have been provided.  If unsure, please check with Tuned Support team for more information.or.</p><h3 class="slate-h3 " >Images</h3><p class="slate-p " >A important note is in regards to Images.  Images are generally provided at the highest resolution available within the URL responses.  This is for Artist Images, Album Images and Artwork (such as playlist images).  You will not want to use this URL as it is usually too large, bit also not right sized for your interfaces.</p><p class="slate-p " >Tuned Global makes an image engine available for both sizing the image required and also applying a number of effects.  This is detailed in <a href="https://app.theneo.io/tuned-global/metadata/image-engine" target="_self">Image Engine</a></p><p class="slate-p " ></p><p class="slate-p " ></p>

Tuned Global Advanced APIs (aAPIs) consist of a group of Metadata, Services and Authentication APIs.

These Metadata APIs are used where user context is not required, the Services APIs are where user context is required.  This means that the security models are different between Metadata and Services APIs.

The Metadata APIs provided READ access to public information about artists, albums, playlists, stations, videos, podcasts, tags and more.  This group of APIs provides the ability to search your catalogue.

General usage of the APIs would be as follows;

The suite of Advanced APIs provide a wide range of tools to get the output you are looking for in regards to your project.  Our team and systems are used in many different use cases, ranging from traditional streaming, metadata usage, background music services, airlines, gaming and web3 experiences to name a few.  Contact our team with you specific use case if you are unsure and we will provide details of the APIs that will provide the results you are looking for.

There are many of the metadata APIs that provide output that you have defined via the AutoTuned CMS.  Instructions on AutoTune CMS are not part of this API documentation but are available via credentials you have been provided.  If unsure, please check with Tuned Support team for more information.or.

A important note is in regards to Images.  Images are generally provided at the highest resolution available within the URL responses.  This is for Artist Images, Album Images and Artwork (such as playlist images).  You will not want to use this URL as it is usually too large, bit also not right sized for your interfaces.

Tuned Global makes an image engine available for both sizing the image required and also applying a number of effects.  This is detailed in 

<p class="slate-p " ><p class="slate-p " >Search provides a number of ways to search the available catalogue.  The “Search” API will provide the broadest response with all other search APIs being more specific.</p></p><p class="slate-p " >Catalogues are made available within these subject to licensing and territories.  The search API will search across all territories you have available and include an available territory node in the response.  You should only display the products available for the territory of the current user.  Any requests for a protected asset (track) for a user where the rights do not exist for their territory will be denied.</p><p class="slate-p " >If your content is gated based on publishing, you will only see the cleared tracks within your catalogue.</p><p class="slate-p " ><p class="slate-p " ></p><p class="slate-p " ></p></p><p class="slate-p " ></p>

Catalogues are made available within these subject to licensing and territories.  The search API will search across all territories you have available and include an available territory node in the response.  You should only display the products available for the territory of the current user.  Any requests for a protected asset (track) for a user where the rights do not exist for their territory will be denied.

If your content is gated based on publishing, you will only see the cleared tracks within your catalogue.

<p class="slate-p " >Tags can be general tags or specific to a tag type, like Genre or Mood. If we have integrated a third party Metadata provider you will also see these as specific tags against your catalogue.The Tuned system supports tags.  These are assigned as follows:</p><ol class="slate-ol " ><li class="slate-li " ><div style="position:relative">At time of ingestion via the supply chain, OR/AND</div></li><li class="slate-li " ><div style="position:relative">Via 3rd party metadata integrations that Tuned manages - examples are Musiio, Music Story or Tivo, OR/AND<p class="slate-p " ></p></div></li><li class="slate-li " ><div style="position:relative">Via the ability to enter tags via AutoTune (CMS)</div></li></ol><p class="slate-p " >Using the AutoTune CMS, tags cane created for;</p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"> Artists</div></li><li class="slate-li " ><div style="position:relative">Albums/Videos</div></li><li class="slate-li " ><div style="position:relative">Podcasts</div></li><li class="slate-li " ><div style="position:relative">Users</div></li><li class="slate-li " ><div style="position:relative">Playlists</div></li><li class="slate-li " ><div style="position:relative">Stations</div></li><li class="slate-li " ><div style="position:relative">Audio Books
</div></li></ul><p class="slate-p " >Tags can be general tags or specific to a tag type, like Genre or Mood.  If we have integrated a third party Metadata provider you will also see these as specific tags against your catalogue.</p><p class="slate-p " >The system will utilise these tags to assist in assist in determining similarity, but they will also be available for you to retrieve products by tags or via Advanced Search.</p><p class="slate-p " ></p><p class="slate-p " ><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ><p class="slate-p " ></p></p><p class="slate-p " ><p class="slate-p " ></p></p></p><p class="slate-p " ></p>

Tags can be general tags or specific to a tag type, like Genre or Mood. If we have integrated a third party Metadata provider you will also see these as specific tags against your catalogue.The Tuned system supports tags.  These are assigned as follows:

Using the AutoTune CMS, tags cane created for;

Tags can be general tags or specific to a tag type, like Genre or Mood.  If we have integrated a third party Metadata provider you will also see these as specific tags against your catalogue.

The system will utilise these tags to assist in assist in determining similarity, but they will also be available for you to retrieve products by tags or via Advanced Search.

<p class="slate-p " ><p class="slate-p " >The services APIs have all end points for user information.  Metadata only provides minimal public information.</p><p class="slate-p " ></p></p><p class="slate-p " ></p>

<p class="slate-p " ></p><div style="text-align:left"><figure ><div style="display:inline-block"><img src="https://theneo-prod-public.s3.amazonaws.com/images-1689311675269.png" alt="" style="
              width:800px;
	            height:439px;
	            aspect-ratio:800 / 439"
         /></div></figure></div><p class="slate-p " >Resize / Apply Filters / Watermark / Crop / More</p><p class="slate-p " >You can use Tuned Global’s automatic image resizing end-point in order to generate images in the size you wish.  The system will resize from the original image automatically.  In order to use and access these images, you will need to first get the Thumbor settings from the TUNED APIs or TUNED directly. </p><p class="slate-p " >The standard URL for Thumbor is provided below in the example, if you have custom URLs configured this may change.</p><p class="slate-p " >In order to get an image., you can then add the Thumbor URL ahead of the image URL (available from the APIs) along with the parameters to resize the image.  </p><p class="slate-p " >An image example is here:
<a href="https://dxfve6m7pg0pq.cloudfront.net/unsafe/420x420/d16npyvi7pcxgr.cloudfront.net/images1004/100/4_0/060/252/790/910/3/104_1004_00602527909103_20220222_1307.jpg" target="_blank"><span style="background-color:rgb(255, 255, 0);color:rgb(17, 85, 204)"><u class="slate-underline">https://dxfve6m7pg0pq.cloudfront.net/unsafe</u></span><span style="background-color:rgb(255, 153, 0);color:rgb(17, 85, 204)"><u class="slate-underline">/420x420/d16npyvi7pcxgr.cloudfront.net</u></span><span style="background-color:rgb(182, 215, 168);color:rgb(17, 85, 204)"><u class="slate-underline">/images1004/100/4_0/060/252/790/910/3/104_1004_00602527909103_20220222_1307.jpg</u></span></a></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Yellow = Thumbor URL</div><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Fixed URL - this is provided to you by Tuned Global
Use this for all your thumbor requests</div></li></ul></li><li class="slate-li " ><div style="position:relative">Orange = request parameters</div><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Detailed below</div></li></ul></li><li class="slate-li " ><div style="position:relative">Green = image information returned in the GetImageURL</div><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Note that the API will return the full URL to the image.<span style="background-color:transparent;color:rgb(0, 0, 0)">
</span>In the example above this would be:  <a href="https://d16npyvi7pcxgr.cloudfront.net/images1004/100/4_0/060/252/790/910/3/104_1004_00602527909103_20220222_1307.jpg" target="_self">https://d16npyvi7pcxgr.cloudfront.net/images1004/100/4_0/060/252/790/910/3/104_1004_00602527909103_20220222_1307.jpg</a></div></li><li class="slate-li " ><div style="position:relative">This image will be the full sized image delivered by the label (format may be converted)</div></li><li class="slate-li " ><div style="position:relative">Exclude the https:// component and use the remainder in your Thumbor request.<span style="background-color:transparent;color:rgb(0, 0, 0)">
</span></div></li></ul></li></ul><p class="slate-p " >Exclude the https:// component and use the remainder your Thumbor request. You must build your URL to request an image suitable for your application. Below is a <em class="slate-italic">Basic</em> model, for a quick start.  There is also an Advanced section if you want to customise and optimise the images being retrieved.<span style="background-color:transparent;color:rgb(0, 0, 0)">
</span><span style="background-color:transparent;color:rgb(0, 0, 0)">
</span><strong class="slate-bold">BASIC
</strong>To simply ask for a resized image, simply specify the size of the image as follows;
<span style="background-color:#FEFF00;color:rgb(0, 0, 0)">[Thumbor URL]</span><span style="background-color:transparent;color:rgb(0, 0, 0)">/</span><span style="background-color:#FE9900;color:rgb(0, 0, 0)">unsafe/[image size]</span><span style="background-color:transparent;color:rgb(0, 0, 0)">/</span><span style="background-color:#B7D6A8;color:rgb(0, 0, 0)">[image URL returned in API]
</span>Image size is defines in pixels width x height</p><p class="slate-p " >Example:
<span style="background-color:#FEFF00;color:rgb(0, 0, 0)">[Thumbor URL]</span><span style="background-color:#FFFFFF;color:rgb(0, 0, 0)">= </span><a href="https://dxfve6m7pg0pq.cloudfront.net" target="_self"><span style="background-color:#FFFFFF;color:rgb(0, 0, 0)">https://dxfve6m7pg0pq.cloudfront.net</span></a>/
<span style="background-color:#FE9900;color:rgb(0, 0, 0)">unsafe/[image size]</span><span style="background-color:#FFFFFF;color:rgb(0, 0, 0)">= unsafe/
</span><span style="background-color:#B7D6A8;color:rgb(0, 0, 0)">[image URL returned in API]</span><span style="background-color:#FFFFFF;color:rgb(0, 0, 0)">= </span><a href="https://d16npyvi7pcxgr.cloudfront.net/images1004/100/4_0/060/252/790/910/3/104_1004_00602527909103_20220222_1307.jpg" target="_self"><span style="background-color:#FFFFFF;color:rgb(0, 0, 0)">d16npyvi7pcxgr.cloudfront.net/images1004/100/4_0/060/252/790/910/3/104_1004_00602527909103_20220222_1307.jpg</span></a></p><p class="slate-p " >Full URL: <a href="https://dxfve6m7pg0pq.cloudfront.net/unsafe/420x1420/d16npyvi7pcxgr.cloudfront.net/images1004/100/4_0/060/252/790/910/3/104_1004_00602527909103_20220222_1307.jpg" target="_blank"><u class="slate-underline">https://dxfve6m7pg0pq.cloudfront.net/unsafe/420x1420/d16npyvi7pcxgr.cloudfront.net/images1004/100/4_0/060/252/790/910/3/104_1004_00602527909103_20220222_1307.jpg</u></a>
Note: This example is the same as Crop in Advanced below.  It is NOT a proportional resize but will crop the image as defined below.  If you wish to proportionally resize you should use Fit</p><div class="slate-hr"><hr contenteditable="false" class="slate-HrElement-hr"/></div><p class="slate-p " ><strong class="slate-bold">ADVANCED</strong></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Re-Size - Define the width and height you wish the image to be resized to, within the parameters below;</div><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Crop</strong><span style="background-color:transparent;color:rgb(0, 0, 0)">
</span>If you do not specify to fit an image within a container, the image will be resized to the largest dimension (w or h) and then cropped to the smallest dimension.</div><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Eg.  Below the same image is set to size 420x1420</div></li><li class="slate-li " ><div style="position:relative"><a href="https://dxfve6m7pg0pq.cloudfront.net/unsafe/420x1420/d16npyvi7pcxgr.cloudfront.net/images1004/100/4_0/060/252/790/910/3/104_1004_00602527909103_20220222_1307.jpg" target="_blank"><span style="background-color:transparent;color:rgb(17, 85, 204)"><u class="slate-underline">https://dxfve6m7pg0pq.cloudfront.net/unsafe/420x1420/d16npyvi7pcxgr.cloudfront.net/images1004/100/4_0/060/252/790/910/3/104_1004_00602527909103_20220222_1307.jpg</u></span></a></div></li><li class="slate-li " ><div style="position:relative">Notes: </div><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">The image is now 1420 high and cropped to the centre 420</div></li><li class="slate-li " ><div style="position:relative">If either dimension number is negative, the image will be flipped horizontally or vertically</div></li></ul></li></ul></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Fit</strong><span style="background-color:transparent;color:rgb(0, 0, 0)"><strong class="slate-bold">
</strong></span>Use the fit-in parameter to ensure an images first into a container with no cropping.  The example URL is<span style="background-color:transparent;color:rgb(0, 0, 0)">
</span><a href="https://dxfve6m7pg0pq.cloudfront.net/unsafe/fit-in/420x420/d16npyvi7pcxgr.cloudfront.net/images1004/100/4_0/060/252/790/910/3/104_1004_00602527909103_20220222_1307.jpg" target="_blank"><span style="background-color:transparent;color:rgb(17, 85, 204)"><u class="slate-underline">https://dxfve6m7pg0pq.cloudfront.net/unsafe/fit-in/420x420/d16npyvi7pcxgr.cloudfront.net/images1004/100/4_0/060/252/790/910/3/104_1004_00602527909103_20220222_1307.jpg</u></span><span style="background-color:transparent;color:rgb(0, 0, 0)">
</span></a>The image will be scaled proportionally to fit into the smallest dimension (w or h)</div><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Eg.  Below the same image is set to size 420x1420</div></li><li class="slate-li " ><div style="position:relative"><a href="https://dxfve6m7pg0pq.cloudfront.net/unsafe/fit-in/420x1420/d16npyvi7pcxgr.cloudfront.net/images1004/100/4_0/060/252/790/910/3/104_1004_00602527909103_20220222_1307.jpg" target="_blank"><span style="background-color:transparent;color:rgb(17, 85, 204)"><u class="slate-underline">https://dxfve6m7pg0pq.cloudfront.net/unsafe/fit-in/420x1420/d16npyvi7pcxgr.cloudfront.net/images1004/100/4_0/060/252/790/910/3/104_1004_00602527909103_20220222_1307.jpg</u></span></a></div></li><li class="slate-li " ><div style="position:relative">Notes:  </div><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">The image retains its proportions and full image (no crop) but is resized to its lowest dimension being 420</div></li><li class="slate-li " ><div style="position:relative">If either dimension number is negative, the image will be flipped horizontally or vertically</div></li></ul></li></ul></li></ul></li><li class="slate-li " ><div style="position:relative">Filters<span style="background-color:transparent;color:rgb(0, 0, 0)">
</span>You can specify multiple filters within a request. Some examples are below.  You can specify more than one filter separated by a colon.</div><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Quality
</strong>Quality is measured from 1-100, higher being better.  You may want to experiment with qualities to ensure that your users experience is optimal (and fast).  We recommend a quality setting of 70 as being a good compromise between quality and size. </div><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><a href="https://dxfve6m7pg0pq.cloudfront.net/unsafe/fit-in/420x420/filters:quality(70)/d16npyvi7pcxgr.cloudfront.net/images1004/100/4_0/060/252/790/910/3/104_1004_00602527909103_20220222_1307.jpg" target="_blank"><span style="background-color:transparent;color:rgb(17, 85, 204)"><u class="slate-underline">https://dxfve6m7pg0pq.cloudfront.net/unsafe/fit-in/420x420/filters:quality(70)/d16npyvi7pcxgr.cloudfront.net/images1004/100/4_0/060/252/790/910/3/104_1004_00602527909103_20220222_1307.jpg</u></span></a></div></li></ul></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Brightness and Contrast
</strong>Adjust the brightness and contract for a specific effect in your application. Both are measured for from -100 to 100</div><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><a href="https://dxfve6m7pg0pq.cloudfront.net/unsafe/fit-in/420x420/filters:quality(70):brightness(-10):contrast(100)/d16npyvi7pcxgr.cloudfront.net/images1004/100/4_0/060/252/790/910/3/104_1004_00602527909103_20220222_1307.jpg" target="_blank"><span style="background-color:transparent;color:rgb(17, 85, 204)"><u class="slate-underline">https://dxfve6m7pg0pq.cloudfront.net/unsafe/fit-in/420x420/filters:quality(70):brightness(-10):contrast(100)/d16npyvi7pcxgr.cloudfront.net/images1004/100/4_0/060/252/790/910/3/104_1004_00602527909103_20220222_1307.jpg</u></span></a></div></li></ul></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Format</strong>
Define if you want to force a format.  The system will normally return a jpeg file, but depending on the original format it may at times return a png.  A JPEG will deliver the smallest file size and hence is recommended.</div><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">format(jpeg) or format(png)</div></li><li class="slate-li " ><div style="position:relative"><a href="https://dxfve6m7pg0pq.cloudfront.net/unsafe/fit-in/420x420/filters:quality(70):brightness(-10):contrast(100):format(jpeg)/d16npyvi7pcxgr.cloudfront.net/images1004/100/4_0/060/252/790/910/3/104_1004_00602527909103_20220222_1307.jpg" target="_blank"><span style="background-color:transparent;color:rgb(17, 85, 204)"><u class="slate-underline">https://dxfve6m7pg0pq.cloudfront.net/unsafe/fit-in/420x420/filters:quality(70):brightness(-10):contrast(100):format(jpeg)/d16npyvi7pcxgr.cloudfront.net/images1004/100/4_0/060/252/790/910/3/104_1004_00602527909103_20220222_1307.jp</u></span></a></div></li></ul></li><li class="slate-li " ><div style="position:relative"><strong class="slate-bold">Watermark
</strong>Define if you wish to use a watermark over your images.</div></li><li class="slate-li " ><div style="position:relative">You can define location, opacity and more</div></li><li class="slate-li " ><div style="position:relative">Usage: watermark(imageUrl, x, y, alpha [, w_ratio [, h_ratio]])</div><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative">Description
This filter adds a watermark to the image. It can be positioned inside the image with the alpha channel specified and optionally resized based on the image size by specifying the ratio (see Resizing).</div></li><li class="slate-li " ><div style="position:relative">Arguments
imageUrl - Watermark image URL. It is very important to understand that the same image loader that Thumbor uses will be used here. If this URL contains parentheses they MUST be url encoded, since these are the characters Thumbor uses as delimiters for filter parameters.
x - Horizontal position that the watermark will be in. Positive numbers indicate position from the left and negative numbers indicate position from the right. If the value is ‘center’ (without the single quotes), the watermark will be centered horizontally. If the value is ‘repeat’ (without the single quotes), the watermark will be repeated horizontally. If the value is a positive or negative number followed by a ‘p’ (ex. 20p) it will calculate the value from the image width as percentage
y - Vertical position that the watermark will be in. Positive numbers indicate position from the top and negative numbers indicate position from the bottom. If the value is ‘center’ (without the single quotes), the watermark will be centered vertically. If the value is ‘repeat’ (without the single quotes), the watermark will be repeated vertically If the value is a positive or negative number followed by a ‘p’ (ex. 20p) it will calculate the value from the image height as percentage
alpha - Watermark image transparency. Should be a number between 0 (fully opaque) and 100 (fully transparent).
w_ratio - percentage of the width of the image the watermark should fit-in, defaults to ‘none’ (without the single quotes) which means it won’t be limited in the width on resizing but also won’t be resized based on this value
h_ratio - percentage of the height of the image the watermark should fit-in, defaults to ‘none’ (without the single quotes) which means it won’t be limited in the height on resizing but also won’t be resized based on this value</div></li></ul></li><li class="slate-li " ><div style="position:relative">Example:</div><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><a href="https://dxfve6m7pg0pq.cloudfront.net/unsafe/fit-in/420x420/filters:watermark(https://d2byqs7e78w6a1.cloudfront.net/DEMO/video/test_meta2/tg-logo-web-1.png,-10,-70p,50)/d16npyvi7pcxgr.cloudfront.net/images1004/100/4_0/060/252/790/910/3/104_1004_00602527909103_20220222_1307.jpg" target="_self">https://dxfve6m7pg0pq.cloudfront.net/unsafe/fit-in/420x420/filters:watermark(https://d2byqs7e78w6a1.cloudfront.net/DEMO/video/test_meta2/tg-logo-web-1.png,-10,-70p,50)/d16npyvi7pcxgr.cloudfront.net/images1004/100/4_0/060/252/790/910/3/104_1004_00602527909103_20220222_1307.jpg</a>
</div></li></ul></li></ul></li><li class="slate-li " ><div style="position:relative">Speak to Tuned Global about your specific needs as further filters are available (eg.  Blur, Saturation and more)</div></li></ul><p class="slate-p " ></p><p class="slate-p " ></p>

Resize / Apply Filters / Watermark / Crop / More

You can use Tuned Global’s automatic image resizing end-point in order to generate images in the size you wish.  The system will resize from the original image automatically.  In order to use and access these images, you will need to first get the Thumbor settings from the TUNED APIs or TUNED directly. 

The standard URL for Thumbor is provided below in the example, if you have custom URLs configured this may change.

In order to get an image., you can then add the Thumbor URL ahead of the image URL (available from the APIs) along with the parameters to resize the image.  

Exclude the https:// component and use the remainder your Thumbor request. You must build your URL to request an image suitable for your application. Below is a 

 model, for a quick start.  There is also an Advanced section if you want to customise and optimise the images being retrieved.

To simply ask for a resized image, simply specify the size of the image as follows;


Image size is defines in pixels width x height


Note: This example is the same as Crop in Advanced below.  It is NOT a proportional resize but will crop the image as defined below.  If you wish to proportionally resize you should use Fit

Sections