Metadata Feed
Incremental and full metadata feed endpoints for change detection and synchronisation. The metadata feed delivers a time-ordered stream of catalogue changes (creates, updates, deletes) so that downstream systems can apply deltas without re-ingesting the full catalogue.
Use the full feed for initial setup, it will then switch to an incremental feeds for ongoing synchronisation.
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
- Metadata Feed