Tuned Global Services aAPIs
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
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.
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
On this page
- Tuned Global Services aAPIs