Tuned Global Metadata aAPIs

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.

Usage

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;

1. Understand the security models assigned to different APIs. Refer to the Authentication Section for more information.
2. 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
3. Use the Services APIs to access contextual information, usually involving the catalogue and the user
4. If you need access to alternate environments, these will need to be added to your MSA (Development)

Use Cases

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.

CMS - AutoTune

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.

Images

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 Image Engine