You are on page 1of 2

Last update 02/20/2023

UPC Collection Match Database Notes


Summary:

This is a dump of the complete Apple Enterprise Partner Feed iTunes Collection Match, Video Match and Song
Match binary files, which contains the information to match any iTunes album ID to an iTunes UPC.
Information on this data can be found at https://performance-partners.apple.com/epf.
The target update period of this data is quarterly.
Source File Information:

The binary files are stored by Apple in a double compressed file


format, using a TAR compressed file format and then encasing that
file in the TBZ compressed file format.
Apple has switched to a backup method for the Enterprise Partner
Feed (EPF) that mirrors iCloud backups of Apple devices
(providing only the current version and most recent prior version).
No historical updates are available under this method.
Effective 12/10/2022, all files will be posted in
the TBZ format to save Google Drive space. You
can use the 7-Zip program,
https://www.7-zip.org, to uncompress these files.
The date in the file name reflects the date that the file was downloaded from Apple.
The file's modify date reflects the date that Apple last updated this file.
The file's modify date does not always correspond with the Apple release date of the file.
Retention Period:
Binary files will be kept this Google Drive folder as follows:
Collection Match and Video Match: three to five years or as Google Drive space permits.
Song Match: one year or as Google Drive space permits
Note: The first saved binary file (saved in tbz format) for the Collection Match and Video Match will not be
removed for historical reference purposes.
Announcements:
Any significant updates will be provided through the Musicbrainz Community thread:
https://community.metabrainz.org/t/itunes-upc-database.
Last update 02/20/2023
Utilizing the file:

Using a binary reader, such as https://www.proxoft.com/BinaryViewer.aspx, a search using the iTunes album ID
in the file will yield a match for the UPC used for the album release. See example using “The Avengers
(Original Motion Picture Soundtrack)“ (Album ID: 1440663549, UPC: 050087281557). Please note that you
may have to add/remove leading zeros in the result.

Taking the UPC and using the iTunes Search API (https://itunes.apple.com/lookup?upc=050087281557) and
opening the resulting text file results in the following information:
{
"resultCount":1,
"results": [
{"wrapperType":"collection", "collectionType":"Album", "artistId":611137, "collectionId":1440663549,
"amgArtistId":125299, "artistName":"Alan Silvestri", "collectionName":"The Avengers (Original Motion
Picture Soundtrack)", "collectionCensoredName":"The Avengers (Original Motion Picture Soundtrack)",
"artistViewUrl":"https://music.apple.com/us/artist/alan-silvestri/611137?uo=4",
"collectionViewUrl":"https://music.apple.com/us/album/the-avengers-original-motion-picture-soundtrack/14406
63549?uo=4",
"artworkUrl60":"https://is2-ssl.mzstatic.com/image/thumb/Music118/v4/17/91/ba/1791ba8d-48d2-9990-2681-2
561916082aa/source/60x60bb.jpg",
"artworkUrl100":"https://is2-ssl.mzstatic.com/image/thumb/Music118/v4/17/91/ba/1791ba8d-48d2-9990-2681-
2561916082aa/source/100x100bb.jpg", "collectionPrice":9.99, "collectionExplicitness":"notExplicit",
"trackCount":18, "copyright":"℗ 2012 Marvel Music, Inc.", "country":"USA", "currency":"USD",
"releaseDate":"2012-01-01T08:00:00Z", "primaryGenreName":"Soundtrack"}]
}

You might also like