CDS Metadata Feed
Tuned Global provides a metadata delivery feed as part of its Catalogue Delivery Specification. Tuned Global accepts catalogue feeds from many labels in different formats. Our ingestion program, Intaga, automatically processes these feeds and normalises the metadata structures. These Tuned Global metadata feeds enable clients to access this normalised structure and receive continuing updates of new products, changed products and takedowns.
You can use the information in these metadata feeds with the Tuned Global Catalogue Delivery APIs detailed here order to access assets. These assets may be Album Artwork, Audio and Video files as per your license agreement.
The Tuned Global Catalogue Delivery Service provides a JSON formatted feed on a scheduled basis. Once the initial feed has been provided, updates can be scheduled every hour, day or week - depending on your needs. These feeds will be made available via an sFTP location that you can access OR an AWS S3 Bucket if you are currently an AWS user.
The files are available for 30 days at which point they are deleted. If you wish to archive these files, that is your responsibility.
Note: If your S3 location is being used, these files will not be deleted and you will need to manage any delete policies within your AWS infrastructure.
OnBoarding
The onboarding process will be as follows;
- The Tuned Global Operations team will connect with you once your service has been approved internally.
- You will provide either S3 details for Metadata files or you will provide a Public Key for sFTP access. The team can assist on these items.
- Tuned will deliver a number of JSON test files as per the specification below.
- You will import these files and confirm that you were able to complete this successfully with Tuned
- Tuned will initiate the initial feed, that includes your licensed catalogue content.
Precedence
Whenever information is conveyed through this Catalogue Delivery Specification, it represents a complete and accurate declaration concerning the Album and Track metadata. This implies that such information should be regarded as self-contained and authoritative, thereby replacing any existing data related to these products within your system.
Manage your Risk
It is critical that you process files in date/time order from oldest to newest. This is to ensure integrity of data in updates and takedowns.
You must take special note of item 2.22 - action. This item denotes whether to treat this product (album) as a new product, an update to your existing data or a takedown.
Rights Management
One of the most critical items to manage is the availability of a product, being an Album or a Track. Making a product available prior to its live date or not removing it after an end date is a significant breach of your licensing agreement and should be treated as a high level risk.
As a general overview the logic to manage rights and availability is:
The following provides instructions on when to make a track OR an album available to your audience. Only where there is a tick against all the elements should you make an album or track available. Please keep in mind that rights to Albums and Tracks are distinct.
The below instructions depend on whether Tuned Global is providing Publishing data or not.
NOTE: REFERENCE TO NOT MAKING AN ALBUM OR TRACK AVAILABLE (LIVE) MEANS, ALL ASPECTS OF AN ALBUM AND OR TRACK. THIS INCLUDES PREVIEWS, ARTWORK, TITLES INCLUDING ALL METADATA.
TERRITORIES AND RIGHTS The JSON feed for the Catalogue Delivery Service may contain territories for which you are not licensed. It is important that within your own system you capture which territories are licensed for a recordLabel (2.32 - labelOwnerID) and then ensure that you only display these products on availability of rights AND having a license for this record label for this territory. Where you wish TUNED to process and manage all rights transparently, we can do so via an Advanced API service.
RULE 1
- Check if Action (2.22) is a TAKEDOWN
- If YES, no further analysis is required, remove the entire album and all its tracks immediately
RULE 2
- Check Metadata below, depending on your use case
- Where Tuned Global is NOT providing Publishing Data
Album Level Rights | |||
2.36 | distFlg | =0 | ✓ |
2.38 | rights | Start Date <=Today and End Date >=Today for each territory. | ✓ |
Album Notes: If no Tracks (below) have rights, you should not display the Album information as no tracks will be available to end users.
Track Level Rights | |||
2.38 | Rights (Album Level) | Start Date <=Today and End Date >=Today for each territory. | ✓ |
2.57 | distFlg | =0 | ✓ |
2.60 | rights | Start Date <=Today and End Date >=Today for each territory. (Applicable to Master rights only). | ✓ |
- Where Tuned Global IS providing Publishing Data
Album Level Rights | |||
2.36 | distFlg | =0 | ✓ |
2.38 | rights | Start Date <=Today and End Date >=Today for each territory. | ✓ |
Album Notes: Publishing Data is only applicable at a track level. If no Tracks (below) have both Master and Publishing rights for a territory, you should not display the Album information as no tracks will be available to end users.
Track Level Rights | |||
2.38 | Rights (Album Level) | Start Date <=Today and End Date >=Today for each territory. | ✓ |
2.57 | distFlg | =0 | ✓ |
2.60 | rights | Start Date <=Today and End Date >=Today for each territory. (Applicable to Master rights only). | ✓ |
2.72 | pubRights | A territory is provided. Note, this means that you can make available for the provided territories only, this should be subject to the end user’s territory. (Applicable to Publishing rights only). | ✓ |
On this page
- CDS Metadata Feed