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 " ><span style="background-color:transparent;color:rgb(0, 0, 0)">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.</span></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 " >Search for user profiles.</p><p class="slate-p " >The max number of results that can be retrieved using the combination of <code class="slate-code">offset</code> and <code class="slate-code">count</code> is <strong class="slate-bold">10,000</strong>.</p><p class="slate-p " ></p>

The max number of results that can be retrieved using the combination of 

UserSearch

API Key provided by Tuned Global for accessing the service

StoreId

Record number to start at, for paging (default 1)

offset

Max number of results to return (default 10)

count

<p class="slate-p " >Search tag by name</p><p class="slate-p " ></p><div class="slate-div"></div><p class="slate-p " ></p><p class="slate-p " ></p><div class="slate-div"></div><p class="slate-p " ></p><p class="slate-p " ></p>

TagSearch

term

<p class="slate-p " ><p class="slate-p " ><span style="background-color:transparent;color:rgb(0, 0, 0)">The Tuned  system supports tags.  
These are assigned as follows:</span></p><ol class="slate-ol " ><li class="slate-li " ><div style="position:relative"><span style="background-color:transparent;color:rgb(0, 0, 0)">At time of ingestion via the supply chain,  OR/AND </span></div></li><li class="slate-li " ><div style="position:relative"><span style="background-color:transparent;color:rgb(0, 0, 0)">Via 3rd party metadata integrations that Tuned manages - examples are Musiio, Music Story or Tivo, OR/AND </span></div></li><li class="slate-li " ><div style="position:relative"><span style="background-color:transparent;color:rgb(0, 0, 0)">Via the ability to enter tags via AutoTune (CMS)</span></div></li></ol><p class="slate-p " ><span style="background-color:transparent;color:rgb(0, 0, 0)">Using the AutoTune CMS, tags can be created for;</span></p><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"><span style="background-color:transparent;color:rgb(0, 0, 0)">Artists</span></div></li><li class="slate-li " ><div style="position:relative"><span style="background-color:transparent;color:rgb(0, 0, 0)">Albums/Videos</span></div></li><li class="slate-li " ><div style="position:relative"><span style="background-color:transparent;color:rgb(0, 0, 0)">Podcasts</span></div></li><li class="slate-li " ><div style="position:relative"><span style="background-color:transparent;color:rgb(0, 0, 0)">Users</span></div></li><li class="slate-li " ><div style="position:relative"><span style="background-color:transparent;color:rgb(0, 0, 0)">Playlists</span></div></li><li class="slate-li " ><div style="position:relative"><span style="background-color:transparent;color:rgb(0, 0, 0)">Stations</span></div></li><li class="slate-li " ><div style="position:relative"><span style="background-color:transparent;color:rgb(0, 0, 0)">Audio Books</span></div></li></ul><p class="slate-p " ><span style="background-color:transparent;color:rgb(0, 0, 0)">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.</span></p></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 class="slate-p " ></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><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 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 " ><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"></div></li></ul></p><p class="slate-p " ><li class="slate-li " ><div style="position:relative"></div></li></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><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ><li class="slate-li " ><div style="position:relative"></div></li></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><p class="slate-p " ></p><p class="slate-p " ><ul class="slate-ul " ><li class="slate-li " ><div style="position:relative"></div></li></ul></p><p class="slate-p " ><li class="slate-li " ><div style="position:relative"></div></li></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><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ><li class="slate-li " ><div style="position:relative"></div></li></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><p class="slate-p " ></p><p class="slate-p " ></p><p class="slate-p " ><li class="slate-li " ><div style="position:relative"></div></li></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><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>

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 " ><span style="background-color:transparent;color:rgb(0, 0, 0)">The services APIs have all end points for user information.  Metadata only provides minimal public information.</span></p><p class="slate-p " ></p></p><p class="slate-p " ></p>

/ 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.  

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

= d16npyvi7pcxgr.cloudfront.net/images1004/100/4_0/060/252/790/910/3/104_1004_00602527909103_20220222_1307.jpg

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