GMD Export

Objects

GMD delivers music data through the objects below.

Entity Relationship Diagram (ERD)

Artist

An artist is an entity with a unique identity and billing. The Artist object enumerates artists contained in GMD music data. An Artist:

• May be an individual, group, or collaboration of any of these.
• Creates Recordings. Recordings are released as Tracks on one or more Album Editions.
• Includes: Artist Factual metadata, Artist Associations, Artist-Level Descriptors, Artist Images and Links to Partner IDs.

For a complete sample see Artist Sample Data. For the full JSON schema see: artist.json_schema

Album Masters

Album Master is a core set of one or more Recordings released under a specific core release title. Includes Factual metadata and Album-Level Descriptors.

For a complete example response, see Album Master Sample. Refer to the full JSON schema to see its objects and properties: album_master.json_schema

Album Editions

The Album Editions object consists of an array of album editions.

• Each album edition is a specific kind of Album Master that has a unique configuration of Recordings. An Album Edition is a specific Edition of Master, comprised of a unique configuration of Recordings.
• Includes: Factual metadata, cover art, Links to Partner IDs for all the Albums released by an Artist.

For a complete example response, see Album Preferred Edition Example. Refer to the full JSON schema to see its objects and properties: album_edition.json_schema.

Recording

A group of acoustically identical or nearly identical tracks by the same Artist. These tracks possibly appear on multiple albums. Gracenote identifies individual Album track instances of the same recording as perceptually identicaI by comparing metadata and acoustic fingerprints.

• These tracks possibly appear on multiple albums. All such Album track instances map to the same Recording ID and descriptive profile.
• Includes Artist Factual metadata, Artist Associations, Artist-Level Descriptors, Artist Images and Links to Partner IDsl by comparing metadata and acoustic fingerprints. All such Album Track instances map to the same Recording ID and descriptive profile.
• Includes Recording Factual metadata, Recording-level descriptors and links to Partner IDs. Normalized Recordings are linked to all Releases that contain that identical Recording.

For a complete example response, see Recording Example. Refer to the full JSON schema to see its objects and properties: recording.json_schema.

Song

The Song object is an array of songs. Song links different tracks of the same composition performed by the same Artist to a single Song ID. This can include studio recordings, live performances, remixes, and so on.

Note: If the same composition is recorded by a different Artist, it is given a different Song ID.

For a complete example response, see Song Example. Refer to the full JSON schema to see its objects and properties: song.json_schema

Example Responses

The example data listed here is based on these searches:

• Artist: "The Beatles"
• Album Master and Preferred Edition: "A Hard Day's Night"
• Song and Recording: "Can't Buy Me Love"

Artist The Beatles

Viewer Example

URL: https://gmd.gracenote.com/artist/GNAR7GZ0H9YQK1J/discography?type=releases&filter=main-canon

Artist JSON Data

Code
 
{
"artists": [
{
"artistID": "GNAR7GZ0H9YQK1J",
"artistName": {
"artistName": "The Beatles",
"languageContext": {"languageID": "74506", "scriptID": "74989"}
},
" objectType": "Group",
"sortName": "Beatles",
"alternateNames": [
{
"artistName": "비틀즈",
"languageContext": {"languageID": "74518", "scriptID": "74983"}
}
],
"nameVariants": [
"The Fab Four",
"The Fabs",
"The Moptops",
"Die Beatles",
"Beatles",
"Les Beatles"
],
"descriptors": {
"genres": [
{"ID": "2834", "weight": "43"},
{"ID": "2844", "weight": "33"},
{"ID": "2804", "weight": "24"}
],
"languages": [
{"ID": "74506", "weight": "100"}
],
"origins": [
{"ID": "4583", "weight": "100"}
],
"eras": [
{"ID": "2633", "weight": "100"}
],
"artistTypes": [
{"ID": "2660", "weight": "100"}
]
},
"disambiguation": "Liverpool British Invasion Rock",
"images": {
"artistImages": [
{
"size": "XLARGE",
"width": "1080",
"height": "1080",
"value": "http://akamai-b.cdn.cddbp.net/cds/2.0/image/0907/CA7C/7B5E/3CF8_xlarge_front.jpg"
}
]},
"externalIDs": {
"artistIDs": [
{
"source": "tms-music-party-id",
"value": "117630"
}
]},
"relatedArtists": {
"bandMembers": [
{
"artistID": "GN40TT5K6EBJ9M9",
"ord": "3",
"artistName": "George Harrison"
},
{
"artistID": "GN3RJW9HCKBZ4YP",
"ord": "1",
"artistName": "John Lennon"
},
{
"artistID": "GND29ZG1KF4BKKN",
"ord": "4",
"artistName": "Ringo Starr"
},
{
"artistID": null,
"ord": "6",
"artistName": "Pete Best"
},
{
"artistID": "GNC9BZAZ5XBY50C",
"ord": "2",
"artistName": "Paul McCartney"
},
{
"artistID": null,
"ord": "5",
"artistName": "Stuart Sutcliffe"
}
],
"memberOfBands": null,
"collaborationMembers": null,
"memberOfCollaborations": [
{
"artistID": "GN1VN1ZH5V7J60B",
"artistName": "The Beatles & Rolf Harris"
},
{
"artistID": "GN6CN4PW6J25H22",
"artistName": "The Beatles & Gene Vincent"
},
{
"artistID": "GN1WX0RMJ6HSRMB",
"artistName": "The Beatles Feat. Billy Preston"
},
{
"artistID": "GN23DXVNG36G8F5",
"artistName": "Tony Sheridan & The Beatles"
}
],
"keyArtists": null,
"similarArtists": [
{
"artistID": "GN2RJN4GRGJWC6P",
"artistName": "The Rolling Stones"
},
{
"artistID": "GNFWS19DEDTNWTJ",
"artistName": "The Byrds"
},
{
"artistID": "GN7ZKH1S7PEV882",
"artistName": "The Who"
},
...
]
}
},
...
]}

Album Master of A Hard Day's Night

Viewer Example

URL: https://gmd.gracenote.com/album/GNCWZ8WY1TTR29G

Album Master JSON Data

Code
 
{
"masters": [
...
{
"albumMasterID": "GNCWZ8WY1TTR29G",
"artist": {
"artistID": "GNAR7GZ0H9YQK1J",
"artistName": "The Beatles"
},
"albumMasterName": "A Hard Day's Night",
"releaseYear": "1964",
"descriptors": {
"genres": [
{"ID": "2834", "weight": "64"},
{"ID": "5675", "weight": "36"}
]
},
"preferredEditionID": "GNF43EMA2H3SCV1",
"languageContexts": [
{"languageID": "74506", "scriptID": "74989", "weight": "100"}
],
"releaseType": {
"ID": "1",
"value": "Main Canon"
}
},
...
]}

Album Preferred Edition of A Hard Day's Night

Viewer Example

URL: https://gmd.gracenote.com/album/GNCWZ8WY1TTR29G/GNF43EMA2H3SCV1

Album Preferred Edition JSON Data

Code
 
{
"editions": [
{
"albumEditionID": "GNF43EMA2H3SCV1",
"artist": {
"artistID": "GNAR7GZ0H9YQK1J",
"artistName": "The Beatles"
},
"albumEditionName": "A Hard Day's Night",
"releaseYear": "1964",
"releaseType": {
"ID": "1",
"value": "Main Canon"
},
"trackCount": "13",
"tracks": [
{
"ord": "1",
"recordingID": "GN5KKSJRDNAPFZP",
"trackName": "A Hard Day's Night",
"artist": {
"artistID": "GNAR7GZ0H9YQK1J",
"artistName": "The Beatles"
}
},
{
"ord": "2",
"recordingID": "GNEK6G927BSP4WC",
"trackName": "I Should Have Known Better",
"artist": {
"artistID": "GNAR7GZ0H9YQK1J",
"artistName": "The Beatles"
}
},
{
"ord": "3",
"recordingID": "GNFSSMAXQJGG836",
"trackName": "If I Fell",
"artist": {
"artistID": "GNAR7GZ0H9YQK1J",
"artistName": "The Beatles"
}
},
{
"ord": "4",
"recordingID": "GN9BK7ZHZFD2JSZ",
"trackName": "I'm Happy Just To Dance With You",
"artist": {
"artistID": "GNAR7GZ0H9YQK1J",
"artistName": "The Beatles"
}
},
{
"ord": "5",
"recordingID": "GNA2TWX2HA8P7EN",
"trackName": "And I Love Her",
"artist": {
"artistID": "GNAR7GZ0H9YQK1J",
"artistName": "The Beatles"
}
},
{
"ord": "6",
"recordingID": "GN6FZT0VVA3HS06",
"trackName": "Tell Me Why",
"artist": {
"artistID": "GNAR7GZ0H9YQK1J",
"artistName": "The Beatles"
}
},
{
"ord": "7",
"recordingID": "GN2AFDQSTMX3VNE",
"trackName": "Can't Buy Me Love",
"artist": {
"artistID": "GNAR7GZ0H9YQK1J",
"artistName": "The Beatles"
}
},
{
"ord": "8",
"recordingID": "GN4PAQCQ72VQ807",
"trackName": "Any Time At All",
"artist": {
"artistID": "GNAR7GZ0H9YQK1J",
"artistName": "The Beatles"
}
},
{
"ord": "9",
"recordingID": "GNAHBSX71PV5AK6",
"trackName": "I'll Cry Instead",
"artist": {
"artistID": "GNAR7GZ0H9YQK1J",
"artistName": "The Beatles"
}
},
{
"ord": "10",
"recordingID": "GNBZZFQR5B569NZ",
"trackName": "Things We Said Today",
"artist": {
"artistID": "GNAR7GZ0H9YQK1J",
"artistName": "The Beatles"
}
},
{
"ord": "11",
"recordingID": "GN9F0PHNC2RDRWC",
"trackName": "When I Get Home",
"artist": {
"artistID": "GNAR7GZ0H9YQK1J",
"artistName": "The Beatles"
}
},
{
"ord": "12",
"recordingID": "GN3QJSCCBVAD8P5",
"trackName": "You Can't Do That",
"artist": {
"artistID": "GNAR7GZ0H9YQK1J",
"artistName": "The Beatles"
}
},
{
"ord": "13",
"recordingID": "GN2X5Q0RD0HRSEQ",
"trackName": "I'll Be Back",
"artist": {
"artistID": "GNAR7GZ0H9YQK1J",
"artistName": "The Beatles"
}
}
],
"images": {
"albumImages": [
{
"size": "XLARGE",
"width": "1080",
"height": "1071",
"value": "http://akamai-b.cdn.cddbp.net/cds/2.0/cover/9FDC/E6C1/90AF/FB0C_xlarge_front.jpg"
}
]},
"albumMasterID": "GNCWZ8WY1TTR29G",
"languageContexts": [
{"languageID": "74506", "scriptID": "74989", "weight": "100"}
]
},
...
]}

Song of Can't Buy Me Love

Viewer Example

URL: https://gmd.gracenote.com/song/GNFK34WT6QHJ5WM

Code
 
**Note**: In the viewer example below, the list of recordings is a result of searching the Recordings data using the "Can't By Me Love" songID GNFK34WT6QHJ5WM.

Song JSON Data

Code
 
{
"songs": [
{
"songID": "GNFK34WT6QHJ5WM",
"artist": {
"artistID": "GNAR7GZ0H9YQK1J",
"artistName": "The Beatles"
},
"songName": "Can't Buy Me Love"
},
...
]}

Recording of Can't Buy Me Love

URL: https://gmd.gracenote.com/recording/GNEB50GY0F5GCZ6

Recording JSON Data

Code
 
"recordingID": "GNEB50GY0F5GCZ6",
"artist": {
"artistID": "GNAR7GZ0H9YQK1J",
"artistName": "The Beatles"
},
"recordingName": "Can't Buy Me Love",
"duration": "135919",
"releaseYear": "1964",
"songID": "GNFK34WT6QHJ5WM",
"externalIDs": {
"trackIDs": [{
"source": "deezer-track-id",
"value": "128519555"
},...
{
"source": "deezer-track-id",
"value": "9849389"
}]
},
"productCodes": [{
"type": "ISRC",
"value": "DEBL60376500"
},
...
{
"type": "ISRC",
"value": "ZA42A1800023"
}],
"descriptors": {
"styles": [{
"ID": "84206",
"weight": "72"
},
{
"ID": "84202",
"weight": "3"
},
{
"ID": "84203",
"weight": "3"
},
{
"ID": "84201",
"weight": "3"
},
{
"ID": "84216",
"weight": "2"
},
{
"ID": "84221",
"weight": "2"
},
{
"ID": "84220",
"weight": "2"
},
{
"ID": "84215",
"weight": "2"
},
{
"ID": "84214",
"weight": "2"
}],
"genres": [{
"ID": "2834",
"weight": "60"
},
{
"ID": "2835",
"weight": "20"
},
{
"ID": "5675",
"weight": "20"
}],
"origins": [{
"ID": "4583",
"weight": "100"
}],
"eras": [{
"ID": "23777",
"weight": "100"
}],
"artistTypes": [{
"ID": "2660",
"weight": "100"
}],
"moods": [{
"ID": "34412",
"weight": "34"
},
{
"ID": "34413",
"weight": "34"
},
{
"ID": "34392",
"weight": "9"
},
{
"ID": "34384",
"weight": "7"
},
{
"ID": "34400",
"weight": "3"
},
{
"ID": "34416",
"weight": "3"
},