Metadata ## Sections • [Tuned Global Metadata aAPIs](https://docs-api-metadata.tunedglobal.com/tuned-global-metadata-aapis.md): 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. 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 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; 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 these metadata APIs as the recommended first step in development Use the 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 • [Authentication](https://docs-api-metadata.tunedglobal.com/authentication.md): Learn how to authenticate your Tuned Global Metadata API requests. All Metadata API requests are authenticated using an API key passed as an HTTP header. Tuned Global will provide your API key once your account is registered. Your key does not expose sensitive user data, it is used to access catalogue metadata such as search results, catalogue metadata and images. API Key Authentication Include your API key on every request using the StoreId HTTP header. ⚠️ Keep your API key private. Do not expose it in client-side code or public repositories. CURL curl --location 'https://api-metadata-connect.tunedglobal.com/api/v2.4/search' \ --header 'StoreId: TESTAPIKEY' \ --header 'Content-Type: application/json' Postman Example • [Get](https://docs-api-metadata.tunedglobal.com/catalogue/release/get.md): Retrieve detail about a specific release • [Getartists](https://docs-api-metadata.tunedglobal.com/catalogue/release/getartists.md): Retrieve detailed collection of artists for the specified release • [Getbyupc](https://docs-api-metadata.tunedglobal.com/catalogue/release/getbyupc.md): Retrieve a list of releases by UPC • [Gettracks](https://docs-api-metadata.tunedglobal.com/catalogue/release/gettracks.md): Retrieve detailed track listing for the specified release • [Getmultiple](https://docs-api-metadata.tunedglobal.com/catalogue/release/getmultiple.md): Return release detail for multiple releases • [Livevideo](https://docs-api-metadata.tunedglobal.com/catalogue/livevideo.md): Live video must be enabled for your service to utilise these endpoints. Live Video Channels and shows are created on AutoTune (CMS). A channel is like a TV or Cable Channel. It allows for many shows to be on the channel, given that only one show can occupy a single time slot. So you can have a show at 7-8pm, then 8-9pm etc. If you require users to be able to choose from two shows in the same time slot, you will need to have two channels created for you.AutoTune provides the publishing point for each channel, meaning that for live content, you can publish to this endpoint. Use the APIs here to access channels and shows. You can contact Tuned Global for more detailed information on Live video.ReferencesBelow are wireframes for how these APIs are used within Tuned Global Turnkey Applications to display channels and events. • [Getlivechannel](https://docs-api-metadata.tunedglobal.com/catalogue/livevideo/getlivechannel.md): Retrieve live channel by channel id. This is header level information • [Getliveshow](https://docs-api-metadata.tunedglobal.com/catalogue/livevideo/getliveshow.md): Retrieve live shows by show id • [Getliveshows](https://docs-api-metadata.tunedglobal.com/catalogue/livevideo/getliveshows.md): Retrieve all the live shows for a channel • [Getliveshowsepoch](https://docs-api-metadata.tunedglobal.com/catalogue/livevideo/getliveshowsepoch.md): Retrieve all the live shows by epoch range. All shows are set in Epoch time. You can convert these time to user local times as required • [Getlivechannelsbyids](https://docs-api-metadata.tunedglobal.com/catalogue/livevideo/getlivechannelsbyids.md): Retrieve multiple live channels by ids • [Author](https://docs-api-metadata.tunedglobal.com/catalogue/author.md): An Author is connected to a Podcast, or the Episode of a Podcast. They are the person that will be displayed as the primary contributor on a podcast or episode, similar to an Artist on an Album or Song. • [Get](https://docs-api-metadata.tunedglobal.com/catalogue/author/get.md): Retrieve the basic details for the specified authhor • [Getpodcastchannelbyauthorid](https://docs-api-metadata.tunedglobal.com/catalogue/author/getpodcastchannelbyauthorid.md): Retrieve detailed listing of podcast channels by this author. Note: a podcast channel is the podcast itself, not the episodes that are part of the podcast • [Getpodcastepisodesbyauthorid](https://docs-api-metadata.tunedglobal.com/catalogue/author/getpodcastepisodesbyauthorid.md): Retrieve detailed listing of podcast episodes by this author • [ValidateTracks](https://docs-api-metadata.tunedglobal.com/catalogue/content-control/validatetracks.md): Retrieve the list of invalid trackIds for offline mode, meaning no longer available. Use this API if you are enabling offline play to check that a track still has rights to be used.This check should be at least once per day unless your licensing requires more. • [ValidateProducts](https://docs-api-metadata.tunedglobal.com/catalogue/content-control/validateproducts.md): Allows users to verify the status of products within the catalogue. This API would return a list of product IDs that are disabled or no longer available. • [GetCatalogueCounts](https://docs-api-metadata.tunedglobal.com/catalogue/content-control/getcataloguecounts.md): Retrieves the total number of songs, artists, and albums available in the catalogue for the current store. • [Podcast](https://docs-api-metadata.tunedglobal.com/catalogue/podcast.md): Podcasts must be enabled for your service. The terminology used is that a Podcast is the parent (not the episodes). A podcast can have episodes or series that then have episodes. This information is available at the header level of a Podcast. • [Get](https://docs-api-metadata.tunedglobal.com/catalogue/podcast/get.md): Retrieve complete detail of a specific podcast channel including episodes • [Getchannel](https://docs-api-metadata.tunedglobal.com/catalogue/podcast/getchannel.md): Retrieve detail about a specific podcast channel • [Getepisode](https://docs-api-metadata.tunedglobal.com/catalogue/podcast/getepisode.md): Retrieve detail about a specific podcast episode • [Similar](https://docs-api-metadata.tunedglobal.com/catalogue/podcast/similar.md): Gets similar Podcast base on Podcast Channel ID tags • [Getall](https://docs-api-metadata.tunedglobal.com/catalogue/podcast/getall.md): Retrieve all podcasts for a service • [Getauthors](https://docs-api-metadata.tunedglobal.com/catalogue/podcast/getauthors.md): Retrieves podcast authors of the current store • [Newpodcast](https://docs-api-metadata.tunedglobal.com/catalogue/podcast/newpodcast.md): Gets the new podcast on the system • [Getepisodes](https://docs-api-metadata.tunedglobal.com/catalogue/podcast/getepisodes.md): Retrieve episodes of a podcast channel • [Track](https://docs-api-metadata.tunedglobal.com/catalogue/track.md): This information is regards to tracks, also known as songs. • [Get play counts for multiple tracks](https://docs-api-metadata.tunedglobal.com/catalogue/track/getmultipletrackplaycounts.md): Retrieve aggregated playback statistics for several tracks with a single request. • [Get play counts for a track](https://docs-api-metadata.tunedglobal.com/catalogue/track/gettrackplaycounts.md): Get the track play count about the given track for the current service. You can use this call if showing global popularity for a track. • [Get replay gain](https://docs-api-metadata.tunedglobal.com/catalogue/track/getreplaygain.md): Retrieve the replay gain analysis for a track. Currently not available. • [Get contributor for a track](https://docs-api-metadata.tunedglobal.com/catalogue/track/getcontributorbytrackid.md): Retrieve a list of contributors base on track id • [Similar](https://docs-api-metadata.tunedglobal.com/catalogue/track/similar.md): Retrieve a list of similar tracks. • [Getclosedcaption](https://docs-api-metadata.tunedglobal.com/catalogue/track/getclosedcaption.md) • [Get](https://docs-api-metadata.tunedglobal.com/catalogue/track/get.md): Retrieve detail about a specific track • [Getmultiple](https://docs-api-metadata.tunedglobal.com/catalogue/track/getmultiple.md): Retrieve track details for multiple tracks • [GetRecommended](https://docs-api-metadata.tunedglobal.com/catalogue/track/getrecommended.md): Retrieve a list of recommended tracks. Uses tags associated to tracks or derived from Albums and/or Artists to determine similarity • [GetIQRecommendations](https://docs-api-metadata.tunedglobal.com/catalogue/track/getiqrecommendations.md): Allows users to retrieve a list of recommended tracks based on specified track IDs. This functionality enables users to enhance their music discovery experience and explore new content tailored to their preferences. • [Gettracksbyisrc](https://docs-api-metadata.tunedglobal.com/catalogue/track/gettracksbyisrc.md): Get a list of tracks by isrc codes Returns all tracks that are available in the catalogue and have the same ISRC code. Note you can also use Search>SongSearchMatching for more options. • [Get favourite count for a track](https://docs-api-metadata.tunedglobal.com/catalogue/track/get-favourite-count.md): Get the favourite count of a single track • [Get favourite counts for multiple tracks](https://docs-api-metadata.tunedglobal.com/catalogue/track/get-favourite-counts-for-multiple-tracks.md): Get the favourite counts for multiple tracks • [Get Audio Analysis](https://docs-api-metadata.tunedglobal.com/catalogue/track/get-audio-analysis.md): Retrieve stored audio-analysis metadata for a track from master metadata storage. • [Song](https://docs-api-metadata.tunedglobal.com/catalogue/song.md): A song is the same as a track • [Getfreesong](https://docs-api-metadata.tunedglobal.com/catalogue/song/getfreesong.md): Retrieve free song id for the service (if activated). Not active by default • [Get](https://docs-api-metadata.tunedglobal.com/catalogue/song/get.md): Retrieve detail for an individual song within the catalogue • [GetSongLyrics](https://docs-api-metadata.tunedglobal.com/catalogue/song/getsonglyrics.md) • [Getartists](https://docs-api-metadata.tunedglobal.com/catalogue/song/getartists.md): Retrieve detailed collection of artists for the specified song. Use this where multiple artists are attributed to a song and then allow users to see more from that artist using Artist API endpoints • [Getchordchart](https://docs-api-metadata.tunedglobal.com/catalogue/song/getchordchart.md): Retrieve chord chart for the specified song Note: This data is only available if Chord Charts are enabled for your service and you or a third party are providing chord charts • [Getmultiple](https://docs-api-metadata.tunedglobal.com/catalogue/song/getmultiple.md): Retrieve details for multiple songs within the catalogue • [Audiobook](https://docs-api-metadata.tunedglobal.com/catalogue/audiobook.md) • [Get](https://docs-api-metadata.tunedglobal.com/catalogue/audiobook/get.md): Retrieve complete detail of a specific audiobook including chapters • [Getaudiobooksbyupc](https://docs-api-metadata.tunedglobal.com/catalogue/audiobook/getaudiobooksbyupc.md): Gets audiobooks by upc • [Getauthorbyauthorid](https://docs-api-metadata.tunedglobal.com/catalogue/audiobook/getauthorbyauthorid.md): Gets author by author id • [Getaudiobook](https://docs-api-metadata.tunedglobal.com/catalogue/audiobook/getaudiobook.md): Retrieve detail about a specific audiobook • [Getaudiobookchapter](https://docs-api-metadata.tunedglobal.com/catalogue/audiobook/getaudiobookchapter.md): Retrieve detail about a specific audiobook chapter • [Getallaudiobooks](https://docs-api-metadata.tunedglobal.com/catalogue/audiobook/getallaudiobooks.md): Retrieve all audiobooks for a store • [Getauthors](https://docs-api-metadata.tunedglobal.com/catalogue/audiobook/getauthors.md): Retrieves audiobook authors of the current store • [Getnewaudiobooks](https://docs-api-metadata.tunedglobal.com/catalogue/audiobook/getnewaudiobooks.md): Gets the new audiobooks on the system • [Getaudiobooksbyauthorid](https://docs-api-metadata.tunedglobal.com/catalogue/audiobook/getaudiobooksbyauthorid.md): Gets audiobooks by author id • [Getaudiobookchaptersbyauthorid](https://docs-api-metadata.tunedglobal.com/catalogue/audiobook/getaudiobookchaptersbyauthorid.md): Gets audiobook chapters by author id • [Getaudiobookchapters](https://docs-api-metadata.tunedglobal.com/catalogue/audiobook/getaudiobookchapters.md): Retrieve chapters of a audiobook • [Artist](https://docs-api-metadata.tunedglobal.com/catalogue/artist.md): The Artist section provides information based on Artists. This includes artist profiles, similar artists and trending information that is global to the service. • [Get](https://docs-api-metadata.tunedglobal.com/catalogue/artist/get.md): Retrieve the basic details for the specified arist. To get an artist id, you can use other APIs such as search, artist Trending or retrieve by tags Note: API output includes MusicStory data. This data will only be provided to you via the APIs, where you have licensed MusicStory, either directly or via Tuned Global through a sub-licence. Where you do not have a license, these nodes will be empty responses. • [Getfullartist](https://docs-api-metadata.tunedglobal.com/catalogue/artist/getfullartist.md): Retrieve full details for the specified arist • [Gettags](https://docs-api-metadata.tunedglobal.com/catalogue/artist/gettags.md): Get all general tags assigned to this artist General tags are assigned using the Tuned Global CMS - AutoTune • [Getuser](https://docs-api-metadata.tunedglobal.com/catalogue/artist/getuser.md): Get the user associated with the artist Note: Community IDs are only available if you have licensed 3rd Party community networks. • [Getartistplaycounts](https://docs-api-metadata.tunedglobal.com/catalogue/artist/getartistplaycounts.md): Get context info, being play accounts, for the given artist for the current service. (Recent plays defined as in last week) • [Similar](https://docs-api-metadata.tunedglobal.com/catalogue/artist/similar.md): Retrieve a list of artists silmilar to the specified artist • [Getstations](https://docs-api-metadata.tunedglobal.com/catalogue/artist/getstations.md): Return top 10 stations this artist has tracks in, ordered by the number of tracks they have in that station • [Derivedtags](https://docs-api-metadata.tunedglobal.com/catalogue/artist/derivedtags.md): Retrieve top 50 tags that have been assigned to this artist and their album(s) • [Getfullartistprofile](https://docs-api-metadata.tunedglobal.com/catalogue/artist/getfullartistprofile.md): Retrieve the complete artist profile details for the specified artist • [Similarbytags](https://docs-api-metadata.tunedglobal.com/catalogue/artist/similarbytags.md): Retrieve a list of artists silmilar to the specified artist • [Get All Artists](https://docs-api-metadata.tunedglobal.com/catalogue/artist/allartists.md): Retrieves a paginated list of all artists available in the current store. A maximum of 10,000 artists can be retrieved using this endpoint. • [Trending](https://docs-api-metadata.tunedglobal.com/catalogue/artist/trending.md): Trending artists for the service • [Getreleases](https://docs-api-metadata.tunedglobal.com/catalogue/artist/getreleases.md): Retrieve detailed listing of releases by this artist • [Getcollaborationsongs](https://docs-api-metadata.tunedglobal.com/catalogue/artist/getcollaborationsongs.md): Retrieve a set of collaboration songs for this artist • [Newartists](https://docs-api-metadata.tunedglobal.com/catalogue/artist/newartists.md): Retrieve a list of new artists New Artists are defined as artists that are new to the system in the last 90 days • [Getalbums](https://docs-api-metadata.tunedglobal.com/catalogue/artist/getalbums.md): Retrieve detailed listing of albums by this artist • [Appearson](https://docs-api-metadata.tunedglobal.com/catalogue/artist/appearson.md): Returns a list of albums where the artist has a track on an album where they are not the primary artist. • [Getsongs](https://docs-api-metadata.tunedglobal.com/catalogue/artist/getsongs.md): Retrieve detailed listing of songs by this artist • [Getmultiple](https://docs-api-metadata.tunedglobal.com/catalogue/artist/getmultiple.md): Retrieve detail for multiple artists • [Getcomposites](https://docs-api-metadata.tunedglobal.com/catalogue/artist/getcomposites.md): Retrieve a list of main artists that are linked to a composite artist. • [GetPlaylists](https://docs-api-metadata.tunedglobal.com/catalogue/artist/getsongs-copy-1.md): The GetPlaylists section allows users to retrieve system playlists associated with a specific artist. This endpoint returns header level playlist info. To get info about the playlist tracks, please use playlist ⇒ GetTracks() API • [Album](https://docs-api-metadata.tunedglobal.com/catalogue/album.md): An album has a primary release associated with it. Unless you have disambiguation technology included in your service, this will be a 1-1 relationship and Albums or Releases can be used interchangeably. • [Get](https://docs-api-metadata.tunedglobal.com/catalogue/album/get.md): Retrieve detail about an individual album within the catalogue. To get an album id, you can use other APIs such as search, artist Get Albums or retrieve by tags. • [Getreleases](https://docs-api-metadata.tunedglobal.com/catalogue/album/getreleases.md): Retrieve detailed listing of releases of this album. Retrieve detailed listing of releases of this album. This is header level information • [Getcontributorbyalbumid](https://docs-api-metadata.tunedglobal.com/catalogue/album/getcontributorbyalbumid.md): Retrieve a list of contributors based on album id • [Newreleases](https://docs-api-metadata.tunedglobal.com/catalogue/album/newreleases.md): Trending New Releases for the store with content language header. Retrieve detailed listing of releases of this album • [New](https://docs-api-metadata.tunedglobal.com/catalogue/album/new.md): Trending new albums for the store with content language header order by priority. Trending new albums for the service with content language header. Trending is defined as the last 30 days • [Trending](https://docs-api-metadata.tunedglobal.com/catalogue/album/trending.md): Trending Album for the store with content language header. Trending new albums for the service with content language header. Trending is defined as the last 30 days • [Newbydate](https://docs-api-metadata.tunedglobal.com/catalogue/album/newbydate.md): Get a list of albums ordered by release date • [Station](https://docs-api-metadata.tunedglobal.com/grouped-catalogue/station.md): A Station is also known in the system as a Mix or Radio. Stations are also called Mixes in our Tuned Global solutions, CMS and documentation. These are groupings of songs that people can listen to in a radio type of usage. This is often referred to as lean back, where there is little input by the user. Users can start the radio station and just like or dislike songs. These likes or dislikes affect the remaining songs they listen to in this station. For this reason you can only ever request the next 5 tracks within a Pre-programmed or programmatic radio station. Access to the actual audio is user based and part of the Services APIs > Services>stations>GetTracks. The items are not played out in the same order for different users, they are affected by algorithms on the back end. Radio can be DMCA or non DMCA compliant, in either case a user never sees a song listing for a station and you cannot retrieve all songs ahead via the APIs. If you are unsure, discuss your needs with Tuned.There are different types of stations, a number are detailed below; Pre-programmed These stations are preprogrammed with a song pool. We would recommend at least 100 tracks in this pool with typically up to 300 tracks entered. You can decide the theme of this station and its content. This is managed via the CMS, A user starts this station and it will play out as expected, taking into account user history and likes/dislikes. Programmatic This is also called station by seed(s). You can request to start a station by seed(s), this is normally an artist. The system will then start a playout of that artist and similar artists. Tags are used extensively to determine this similarity. A user starts this station and it will play out as expected, taking into account user history and likes/dislikes. This API is based on a user's context and is part of the Services APIs. External External Radio is a radio feed that is available from a different (not TUNED) system. You may have an agreement with a local radio station and wish to make the listening of that station available within your application. Where this feature is enabled, you will be able to create this Station within the CMS and then use the APIs to get the information to display and play this station Tags Stations can be grouped as tags, using the AutoTune CMS. You can then utilize the Tag group of APIs to get all stations from a tag and display these accordingly in your application. • [Get](https://docs-api-metadata.tunedglobal.com/grouped-catalogue/station/get.md): Retrieve the detail for the specified station. This is a system Radio station • [Gettrendingpresets](https://docs-api-metadata.tunedglobal.com/grouped-catalogue/station/gettrendingpresets.md): Get the top trending Preset (system) Stations, These can be filtered by content languages (language of performance) if any are applicable • [Getsimilar](https://docs-api-metadata.tunedglobal.com/grouped-catalogue/station/getsimilar.md): Get similar stations. These are stations that share the most tracks by the same artists • [Gettrendingartists](https://docs-api-metadata.tunedglobal.com/grouped-catalogue/station/gettrendingartists.md): Returns a list of 20 artists, ordered by the number of user liked songs in any station within a rolling month. • [Getidentifiers](https://docs-api-metadata.tunedglobal.com/grouped-catalogue/station/getidentifiers.md): Retrieve all identifiers of a station • [Getpresets](https://docs-api-metadata.tunedglobal.com/grouped-catalogue/station/getpresets.md): Retrieve all stations. This is header level information • [Getstationtrendingartists](https://docs-api-metadata.tunedglobal.com/grouped-catalogue/station/getstationtrendingartists.md): Returns the top trending artists in stations. This is a list of 10 artists, ordered by number of liked songs in a station in a rolling month • [GetTracks](https://docs-api-metadata.tunedglobal.com/grouped-catalogue/shadowqueue/gettracks.md): Retrieve the next two tracks in the shadow queue, either based on the current epoch or the epoch end of the last returned track. This functionality provides a seamless way to access and manage upcoming tracks within a specific shadow queue. • [GetPlayHistory](https://docs-api-metadata.tunedglobal.com/grouped-catalogue/shadowqueue/getplayhistory.md): Retrieve the shadow queue play history of tracks in the shadow queue from the past 3 hours. • [Playlist](https://docs-api-metadata.tunedglobal.com/grouped-catalogue/playlist.md): Within the metadata APIs the playlists available are; System Playlists, and Shared playlists - A shared playlist is a user playlist that has been made public, used currently for verified profiles. Use these APIs to get the details of these playlists, including summary and display information, along with track information. Where you have grouped a number of playlists together utilising tags, use the Get Playlists By Tags APIs • [Get](https://docs-api-metadata.tunedglobal.com/grouped-catalogue/playlist/get.md): Get playlist summary information. This is header information • [Tracks](https://docs-api-metadata.tunedglobal.com/grouped-catalogue/playlist/tracks.md): Get playlist track details by playlist ID. Provides a list of the tracks and order of those tracks. Use the track id to get a track stream • [Trending](https://docs-api-metadata.tunedglobal.com/grouped-catalogue/playlist/trending.md): Get trending playlists. These are defined as trending in the last 30 days. • [Getuserpublicplaylists](https://docs-api-metadata.tunedglobal.com/grouped-catalogue/playlist/getuserpublicplaylists.md): Get a user’s public playlists (created by that user) • [GetPlaylistExplicitStatus](https://docs-api-metadata.tunedglobal.com/grouped-catalogue/playlist/getplaylistexplicitstatus.md): This API allows users to determine whether a playlist contains tracks with explicit lyrics by returning a boolean value. • [GetPlaylistFavouriteCount](https://docs-api-metadata.tunedglobal.com/grouped-catalogue/playlist/getplaylistfavouritecount.md): This section allows users to retrieve the number of 'favourites' for a playlist. Users can access key information about the playlist, including its creator, track count, duration, and more. • [GetPlaylists](https://docs-api-metadata.tunedglobal.com/grouped-catalogue/playlist/getplaylists.md): The API allows users to retrieve published system playlists created by administrators, including details such as playlist names, descriptions, creator information, track counts, and more. • [Getplaylistsbytrackid](https://docs-api-metadata.tunedglobal.com/grouped-catalogue/playlist/getplaylistsbytrackid.md): Get all the public playlists by track id. • [Getplaylistsbyverifieduser](https://docs-api-metadata.tunedglobal.com/grouped-catalogue/playlist/getplaylistsbyverifieduser.md): Get playlists that are created by verified users and are public. Set a user to be a verified user via Autotune. That user can then make their playlists public and if so they will be visible via this end point. • [Getplaylistsbyverifiedusers](https://docs-api-metadata.tunedglobal.com/grouped-catalogue/playlist/getplaylistsbyverifiedusers.md): Get playlists created by verified users in the current service. Filter by various options. • [Page](https://docs-api-metadata.tunedglobal.com/content-pages-and-carousel/page.md): These APIs get carousel items that have been created in the CMS. Support exists for carousel by Country or by Language • [Getitems](https://docs-api-metadata.tunedglobal.com/content-pages-and-carousel/page/getitems.md): Get all item details used in a carousel • [Getpublicitems](https://docs-api-metadata.tunedglobal.com/content-pages-and-carousel/page/getpublicitems.md): Get public items within carousel • [Carouselbylanguage](https://docs-api-metadata.tunedglobal.com/content-pages-and-carousel/page/carouselbylanguage.md): Carousel By Language • [Carouselbycountry](https://docs-api-metadata.tunedglobal.com/content-pages-and-carousel/page/carouselbycountry.md): Get carousel by country • [Content](https://docs-api-metadata.tunedglobal.com/content-pages-and-carousel/content.md): Content is defined as a content page, think of this as a page that may contain many other references to albums, songs or artists but is the overall container. Using the Tuned Global CMS, Autotune, you can create a content page and this is represented by its key. If you don't have access to a Tuned Global Whitelabel application, you can request access and see how these content pages cn be used to create dynamic content. • [Get](https://docs-api-metadata.tunedglobal.com/content-pages-and-carousel/content/get.md): Get content based on content key.Content is defined as a content page.Within the Tuned Whitelabel applications, this endpoint is used to get a CMS created content page by its key. i.e. If an image on the homepage is linked to 'new_albums', the applications would call this api with the content key 'new_albums' to retrieve the content page. • [Group](https://docs-api-metadata.tunedglobal.com/settings/group.md): A Group is the terminology used by Tuned Global to define a service for a single client • [Getterms](https://docs-api-metadata.tunedglobal.com/settings/group/getterms.md): Return terms and conditions. • [Getlanguages](https://docs-api-metadata.tunedglobal.com/settings/group/getlanguages.md): Get all available languages for this service. These languages are defined at the time of initialization of a service. • [Getotpprovider](https://docs-api-metadata.tunedglobal.com/settings/group/getotpprovider.md): Get OTPProvider for this group. This is the Mobile OTP provider for the service and is configured at time of service initialization. Examples are Firebase, Twiio or a specific Telco • [Adbannersizes](https://docs-api-metadata.tunedglobal.com/settings/group/adbannersizes.md): Retrieve the list of supported ad banner sizes for the current service. • [Getcontentlanguages](https://docs-api-metadata.tunedglobal.com/settings/group/getcontentlanguages.md): Return all content languages • [Adbannersize](https://docs-api-metadata.tunedglobal.com/settings/group/adbannersize.md): Retrieve a single ad banner size definition for the current store • [Getwebhookcount](https://docs-api-metadata.tunedglobal.com/settings/group/getwebhookcount.md): Get clevertap webhook request count for this service for this month. Use this API where you have clevertap webhooks enabled to allow a targeted content message to users. This will enable you to determine expected charges. • [Search](https://docs-api-metadata.tunedglobal.com/search.md): 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. 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. • [AudiobookChapterSearch](https://docs-api-metadata.tunedglobal.com/search/audiobook-search/audiobookchaptersearch.md): Search for audiobook chapters. The max number of results that can be retrieved using the combination of offset and count is 10,000 . • [AudiobookAuthorSearch](https://docs-api-metadata.tunedglobal.com/search/audiobook-search/search-for-audiobook-authors.md): Search for audiobook authors. The max number of results that can be retrieved using the combination of offset and count is 10,000 . • [AudiobookSearch](https://docs-api-metadata.tunedglobal.com/search/audiobook-search/audiobooksearch.md): Search for audiobooks. The max number of results that can be retrieved using the combination of offset and count is 10,000 . • [Thirdpartycataloguestatus](https://docs-api-metadata.tunedglobal.com/search/catalogue/thirdpartycataloguestatus.md): Search third party catalogue, meaning NOT the Tuned catalogue (if applicable) • [AlbumSearch](https://docs-api-metadata.tunedglobal.com/search/catalogue/albumsearch.md): Search for albums only. The max number of results that can be retrieved using the combination of offset and count is 10,000 . • [AdvancedSongSearch](https://docs-api-metadata.tunedglobal.com/search/catalogue/advancedsongsearch.md): Advanced song search. Multiple input parameters supported. If your service has custom tag groups included, these can be exposed via this search end point. The API takes into account the popularity of songs, as well as the priority configured in Tuned Global’s system when ranking search results, which helps promote more popular and higher-priority songs in the results. The max number of results that can be retrieved using the combination of offset and count is 10,000 . • [PlaylistSearch](https://docs-api-metadata.tunedglobal.com/search/catalogue/playlistsearch.md): Search for playlists. The max number of results that can be retrieved using the combination of offset and count is 10,000 . • [SongSearchMatching](https://docs-api-metadata.tunedglobal.com/search/catalogue/songsearchmatching.md): Search for songs using isrc, song tile, artist title or song duration. The max number of results that can be retrieved using the combination of offset and count is 10,000 . • [Search](https://docs-api-metadata.tunedglobal.com/search/catalogue/search.md): The Search section allows users to search across the catalogue and retrieve all available categories such as Songs, Stations, Playlists, and Videos. Users can easily discover and access various types of content within the platform through this feature. The max number of results that can be retrieved using the combination of offset and count is 10,000 . • [StationSearch](https://docs-api-metadata.tunedglobal.com/search/catalogue/stationsearch.md): Search stations only. The max number of results that can be retrieved using the combination of offset and count is 10,000 . • [ArtistSearch](https://docs-api-metadata.tunedglobal.com/search/catalogue/artistsearch.md): Search for artists only. The max number of results that can be retrieved using the combination of offset and count is 10,000 . • [SongSearch](https://docs-api-metadata.tunedglobal.com/search/catalogue/songsearch.md): Search for songs across the catalog using keywords that match both song titles and artist names. This flexible search returns relevant results without requiring an exact title match, enabling broad discovery within the music metadata. For precise title-only searches, consider using the AdvancedSongSearch. Search for songs. The max number of results that can be retrieved using the combination of offset and count is 10,000 . Note: This search API is not STRICT on song title only, it does include an Artists Name as part of the search algorithm. If you are requiring a STRICT search on title, use AdvancedSongSearch, with input only on title. • [VideoSearch](https://docs-api-metadata.tunedglobal.com/search/catalogue/videosearch.md): Search for videos. Note these are Video on Demand, not Live Video, separate call is available for Live Video. The max number of results that can be retrieved using the combination of offset and count is 10,000 . • [SearchTerm Top](https://docs-api-metadata.tunedglobal.com/search/catalogue/searchterm-copy-1.md): Retrieves the most frequently searched terms • [SearchTerm](https://docs-api-metadata.tunedglobal.com/search/catalogue/videosearch-copy-1.md): Logs user search terms. This endpoint enhances search analytics by offering insights into user behavior, allowing for better search relevance and improved content recommendations. • [SearchTerm Top Products](https://docs-api-metadata.tunedglobal.com/search/catalogue/searchterm-copy-2.md): Retrieves the most frequently searched products e.g. Songs, Albums, Arists. • [LiveChannelSearch](https://docs-api-metadata.tunedglobal.com/search/live-shows/livechannelsearch.md): Search for live video channels. The max number of results that can be retrieved using the combination of offset and count is 10,000 . • [LiveShowSearch](https://docs-api-metadata.tunedglobal.com/search/live-shows/liveshowsearch.md): Search for live video channels. A channel is the header to the live video shows. The max number of results that can be retrieved using the combination of offset and count is 10,000 . • [AuthorSearch](https://docs-api-metadata.tunedglobal.com/search/podcast-search/authorsearch.md): Search for authors only. The max number of results that can be retrieved using the combination of offset and count is 10,000 . • [EpisodeSearch](https://docs-api-metadata.tunedglobal.com/search/podcast-search/episodesearch.md): Search for episodes. Search for podcast episodes only. The max number of results that can be retrieved using the combination of offset and count is 10,000 . • [ChannelSearch](https://docs-api-metadata.tunedglobal.com/search/podcast-search/channelsearch.md): Search for channels. Search for channels (podcasts) only. The max number of results that can be retrieved using the combination of offset and count is 10,000 . • [UserSearch](https://docs-api-metadata.tunedglobal.com/search/tags-and-users/usersearch.md): Search for user profiles. The max number of results that can be retrieved using the combination of offset and count is 10,000 . • [TagSearch](https://docs-api-metadata.tunedglobal.com/search/tags-and-users/tagsearch.md): Search tag by name • [Testconnection](https://docs-api-metadata.tunedglobal.com/search/other/testconnection.md): To test api connection. Use for monitoring search • [Gettrendingterms](https://docs-api-metadata.tunedglobal.com/search/other/gettrendingterms.md): GetTrendingTerms. This will return trending artist searches • [Tags](https://docs-api-metadata.tunedglobal.com/tags.md): 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: At time of ingestion via the supply chain, OR/AND Via 3rd party metadata integrations that Tuned manages - examples are Musiio, Music Story or Tivo, OR/AND Via the ability to enter tags via AutoTune (CMS) Using the AutoTune CMS, tags cane created for; Artists Albums/Videos Podcasts Users Playlists Stations Audio Books 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. • [Getbyname](https://docs-api-metadata.tunedglobal.com/tags/getbyname.md): Retrieve a tag via its unique name • [Getmultiplebyname](https://docs-api-metadata.tunedglobal.com/tags/getmultiplebyname.md): Retrieve multiple tags via its name list • [Getartistsbytag](https://docs-api-metadata.tunedglobal.com/tags/getartistsbytag.md) • [Getpodcastchannelbytag](https://docs-api-metadata.tunedglobal.com/tags/getpodcastchannelbytag.md): Retrieve podcast channel that have been assigned to this tag • [Getalbumsbytag](https://docs-api-metadata.tunedglobal.com/tags/getalbumsbytag.md) • [Getstationsbytag](https://docs-api-metadata.tunedglobal.com/tags/getstationsbytag.md) • [Getaudiobooksbytag](https://docs-api-metadata.tunedglobal.com/tags/getaudiobooksbytag.md): Retrieve Audiobooks that have been assigned to this tag • [Getalbumsbytaggroups](https://docs-api-metadata.tunedglobal.com/tags/getalbumsbytaggroups.md) • [Getartistsbytaggroups](https://docs-api-metadata.tunedglobal.com/tags/getartistsbytaggroups.md) • [Gettagsbytagtype](https://docs-api-metadata.tunedglobal.com/tags/gettagsbytagtype.md): Retrieve tags by tag type. • [GetPlaylistsByTag](https://docs-api-metadata.tunedglobal.com/tags/getplaylistsbytag.md): The API allows users to retrieve a list of playlists based on a specified tag. The results are sorted by priority and then by a given sort type, enabling users to access relevant playlists efficiently. This section provides valuable insights into organizing and accessing playlists based on specific tags. • [GetPlaylistsByTags](https://docs-api-metadata.tunedglobal.com/tags/getplaylistsbytags.md): The API allows users to retrieve a list of playlists based on specific tags. The results are sorted by a given sort type, enabling users to access relevant playlists efficiently. • [GetSongsByTag](https://docs-api-metadata.tunedglobal.com/tags/getsongsbytag.md): Retrieve a curated list of songs associated with specific tags, enabling users to discover tracks that match particular themes or categories. The response includes detailed metadata for each song, such as artist information, album details, rights data, and track attributes, supporting rich integration and filtering capabilities. • [User](https://docs-api-metadata.tunedglobal.com/user.md): The services APIs have all end points for user information. Metadata only provides minimal public information. • [Getprofilebyid](https://docs-api-metadata.tunedglobal.com/user/getprofilebyid.md): Get User Public Profile by user Id. Note: A user must have their allow public as active • [Getfollowing](https://docs-api-metadata.tunedglobal.com/user/getfollowing.md): Retrieve a list of profiles (ids) the given public user is following. • [Getprofilebyusername](https://docs-api-metadata.tunedglobal.com/user/getprofilebyusername.md): Get User Public Profile by username. Note: A user must have their allow public as active • [Externalemailexists](https://docs-api-metadata.tunedglobal.com/user/externalemailexists.md): Check if email exists in third party systems. Note: This API is only available if 3rd party authentication systems are used and this feature is available. It is not available by default. • [Image Engine](https://docs-api-metadata.tunedglobal.com/image-engine.md): 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. An image example is here: https://dxfve6m7pg0pq.cloudfront.net/unsafe /420x420/d16npyvi7pcxgr.cloudfront.net /images1004/100/4_0/060/252/790/910/3/104_1004_00602527909103_20220222_1307.jpg Yellow = Thumbor URL Fixed URL - this is provided to you by Tuned Global Use this for all your thumbor requests Orange = request parameters Detailed below Green = image information returned in the GetImageURL Note that the API will return the full URL to the image. In the example above this would be: https://d16npyvi7pcxgr.cloudfront.net/images1004/100/4_0/060/252/790/910/3/104_1004_00602527909103_20220222_1307.jpg This image will be the full sized image delivered by the label (format may be converted) Exclude the https:// component and use the remainder in your Thumbor request. 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 Basic model, for a quick start. There is also an Advanced section if you want to customise and optimise the images being retrieved. BASIC To simply ask for a resized image, simply specify the size of the image as follows; [Thumbor URL] / unsafe/[image size] / [image URL returned in API] Image size is defines in pixels width x height Example: [Thumbor URL] = https://dxfve6m7pg0pq.cloudfront.net / unsafe/[image size] = unsafe/ [image URL returned in API] = d16npyvi7pcxgr.cloudfront.net/images1004/100/4_0/060/252/790/910/3/104_1004_00602527909103_20220222_1307.jpg Full URL: https://dxfve6m7pg0pq.cloudfront.net/unsafe/420x1420/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 ADVANCED Re-Size - Define the width and height you wish the image to be resized to, within the parameters below; Crop 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. Eg. Below the same image is set to size 420x1420 https://dxfve6m7pg0pq.cloudfront.net/unsafe/420x1420/d16npyvi7pcxgr.cloudfront.net/images1004/100/4_0/060/252/790/910/3/104_1004_00602527909103_20220222_1307.jpg Notes: The image is now 1420 high and cropped to the centre 420 If either dimension number is negative, the image will be flipped horizontally or vertically Fit Use the fit-in parameter to ensure an images first into a container with no cropping. The example URL is 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 The image will be scaled proportionally to fit into the smallest dimension (w or h) Eg. Below the same image is set to size 420x1420 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 Notes: The image retains its proportions and full image (no crop) but is resized to its lowest dimension being 420 If either dimension number is negative, the image will be flipped horizontally or vertically Filters You can specify multiple filters within a request. Some examples are below. You can specify more than one filter separated by a colon. Quality 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. 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 Brightness and Contrast Adjust the brightness and contract for a specific effect in your application. Both are measured for from -100 to 100 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 Format 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. format(jpeg) or format(png) 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 Watermark Define if you wish to use a watermark over your images. You can define location, opacity and more Usage: watermark(imageUrl, x, y, alpha [, w_ratio [, h_ratio]]) 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). 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 Example: 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 Speak to Tuned Global about your specific needs as further filters are available (eg. Blur, Saturation and more)