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

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

Services APIs are secured using access token (JWT) - oAuth 2.0

Usage

The Services APIs provide access to private information about users, artists, albums, playlists, stations, videos, podcasts, tags and more. This group of APIs provides user context to many of the APIs in Metadata along with many that are unique to Services

General usage of the APIs would be as follows;

Understand the security models assigned to different APIs. Refer to the Authentication Section for more information.
If you are initially building a general access view, where user context is not required, use the metadata APIs as the recommended first step in development
Use these Services APIs to access contextual information, usually involving the catalogue and the user
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

Sections