Artist & product endpoints

Parameter Structure

The parameters are expected in the following sequence:

  1. Country : The country of the requested object (AT, CH, DE)
  2. Object Type : The type of object to be requested
  3. Object Id : The Id of the requested object
  4. Field Type : The Field of the requested object

The parameters Country and Object Type are mandatory.

Request:
GET http://api.sonymusic.de/DE/label



Response: list of all available labels of the requested country, sorted by label name
[
	{
		"id": 12345,
		"name": "Ariola",
		"country": "DE"
	},
	{
		"id": 54321,
		"name": "Columbia",
		"country": "DE"
	},
	{...}
]
Request:
GET http://api.sonymusic.de/DE/label/1



Response: list of all available regular and compilation artists of the requested label, sorted by artist name
{
	"id": 1,
	"name": "Ariola",
	"country": "DE",
	"artists": {
		"regularArtists": [
			{
				"id": 256816,
				"name": "Michael Wendler",
				"country": "DE"
			},
			{...}
		],
		"compilationArtists": [
			{
				"id": 1,
				"name": "Club Sounds",
				"country": "DE"
			},
			{...}
		]
	}
}
Request:
GET https://api.sonymusic.de/*/all-artists



Response: list all available artists from all countries. Sorted by artist name
{
{
    metadata: {
        count: 9992,
        time: 0.037820816040039
    },
    data: [
        {
            id: "10005",
            country: "AT",
            name: "June Tabor",
            indexName: "Tabor, June",
            top: "0",
            created: "2018-03-16 16:20:41",
            lastUpdate: "2018-03-16 16:20:41"
        },
        {
            id: "10005",
            country: "CH",
            name: "June Tabor",
            indexName: "Tabor, June",
            top: "0",
            created: "2018-03-16 16:21:18",
            lastUpdate: "2018-03-16 16:21:18"
        },
        {...}
     ]
}
Request:
GET http://api.sonymusic.de/DE/artist/6257



Response: details of the requested artist
{
  "id": "6257",
  "country": "DE",
  "name": "Peter Maffay",
  "indexName": "Maffay, Peter",
  "influencedBy": null,
  "biography": "Peter Maffay\r\n\r\nGesang, Gitarre\r\n\r\nAls der noch 19-j\u00e4hrige ...",
  "pictures": {
    "backgroundPortrait": {
      "id": "144876",
      "artistId": "6257",
      "url": "http:\/\/news.sonymusic.de\/PARI\/KAT\/DOCU0\/FOTO3\/I\/6257-45483I37003.jpg",
      "photographer": " ",
      "comment": "Peter Maffay_Wenn das so ist LIVE_Pressefoto 3_Credits: Urs M\u00fcller",
      "created": "2014-10-05T16:33:57+02:00",
      "lastUpdate": "2016-10-24T12:32:41+02:00"
    },
    "backgroundLandscape": {
      "id": "144878",
      "artistId": "6257",
      "url": "http:\/\/news.sonymusic.de\/PARI\/KAT\/DOCU0\/FOTO3\/I\/6257-45484I37004.jpg",
      "photographer": " ",
      "comment": "Peter Maffy_Wenn das so ist LIVE_Pressefoto 4_Credits: Urs M\u00fcller",
      "created": "2014-10-05T16:33:57+02:00",
      "lastUpdate": "2016-10-24T12:32:41+02:00"
    },
    "backgroundArtist": null,
    "gallery": [
      {
        "id": "79173",
        "artistId": "6257",
        "url": "http:\/\/news.sonymusic.de\/PARI\/KAT\/DOCU0\/FOTO3\/I\/6257-28942I18419.jpg",
        "photographer": "Andreas Ortner",
        "comment": "Andreas Ortner 2010",
        "created": "2013-11-25T22:26:30+01:00",
        "lastUpdate": "2013-11-25T22:26:30+01:00"
      },
      {...}
    ]
  },
  "appIcon": null,
  "publish": null,
  "cnames": [
    {
      "id": "6257DE",
      "country": "DE",
      "cname": "peter-maffay",
      "domain": "artists.sonymusic.de",
      "slug": "append",
      "priority": null,
      "created": "2013-11-25T22:26:52+01:00",
      "lastUpdate": "2013-11-25T22:26:52+01:00"
    }
  ],
  "websites": [
    {
      "id": "1410",
      "website": "www.maffay.de",
      "type": "artistWebsite",
      "comment": "www.maffay.de",
      "created": "2016-10-20T06:46:55+02:00",
      "lastUpdate": "2016-10-20T12:46:55+02:00"
    },
    {...}
  ],
}
Request:
GET http://api.sonymusic.de/DE/artist/6257/products



Response: products of the requested artist
[
	{
		"id": "88697769762",
		"title": "Tattoos - Premium Edition",
		"artistId": 6257,
		"artistName": "Peter Maffay",
		"releaseType": null,
		"releaseDate": "2010-01-10",
		"artwork": "http:\/\/news.sonymusic.de\/\/PARI\/KAT\/COVER1\/JPG300X300DPI2\/P\/88697769762.jpg",
		"purchase": null,
		"description": "PETER MAFFAY - DIE ROCK N ROLL ZEITREISE GEHT WEITER! ...",
		"productFamilyId":"2299973"
	},
	{...}
]
Request:
GET http://api.sonymusic.de/DE/artist/58035/events



Response: Songkick events of the requested artist
{
    metadata: {
        artistId: "58035",
        artistName: "Andrea Berg",
        count: 22,
        time: 0.002946138381958008
    },
    data: [
        {
            id: "35489904",
            artistId: "58035",
            location: {
            city: "Chemnitz, Germany",
            lat: 50.81858,
            lng: 12.88095
        },
        popularity: "0.001515",
        uri: "http://www.songkick.com/concerts/35489904-andrea-berg-at-messe?utm_source=42436&utm_medium=partner",
        displayName: "Andrea Berg at Messe (February 6, 2020)",
        type: "Concert",
        ageRestriction: "0",
        start: {
            date: "2020-02-06",
            datetime: null,
            time: null
        },
        performance: [
            {
                id: 67895519,
                displayName: "Andrea Berg",
                billing: "headline",
                billingIndex: 1,
                artist: {
                    id: 504934,
                    displayName: "Andrea Berg",
                    uri: "http://www.songkick.com/artists/504934-andrea-berg?utm_source=42436&utm_medium=partner",
                    identifier: [
                        {
                            mbid: "f8653ae9-b729-4f36-99a5-e05eae90b640",
                            href: "http://api.songkick.com/api/3.0/artists/mbid:f8653ae9-b729-4f36-99a5-e05eae90b640.json"
                        }
                    ]
                }
            }
        ],
        venue: {
            id: 489436,
            displayName: "Messe",
            uri: "http://www.songkick.com/venues/489436-messe?utm_source=42436&utm_medium=partner",
            metroArea: {
                displayName: "Chemnitz",
                country: {
                    displayName: "Germany"
                },
                id: 28455,
                uri: "http://www.songkick.com/metro_areas/28455-germany-chemnitz?utm_source=42436&utm_medium=partner"
            },
            lat: 50.81858,
            lng: 12.88095
        },
            created: "2020-01-30T09:56:59+01:00",
            lastUpdate: null
        },
    {...}
]
Request:
GET http://api.sonymusic.de/DE/artist/6257/pictures



Response: a list of pictures related to the artist
{
    backgroundPortrait: {
        id: "177267",
        artistId: "58035",
        url: "http://news.sonymusic.de/PARI/KAT/DOCU0/FOTO3/I/58035-52992I45537.jpg",
        photographer: "(c) Bergrecords",
        comment: "Pressefotos 2017",
        created: "2018-03-16T16:25:37+01:00",
        lastUpdate: "2018-03-16T16:25:37+01:00"
    },
    backgroundLandscape: {
        id: "177273",
        artistId: "58035",
        url: "http://news.sonymusic.de/PARI/KAT/DOCU0/FOTO3/I/58035-52993I45538.jpg",
        photographer: "(c) Bergrecords",
        comment: "Pressefotos 2017",
        created: "2018-03-16T16:25:37+01:00",
        lastUpdate: "2018-03-16T16:25:37+01:00"
    },
    backgroundArtist: {
        id: "177274",
        artistId: "58035",
        url: "http://news.sonymusic.de/PARI/KAT/DOCU0/FOTO3/I/58035-52993I45538.jpg",
        photographer: "(c) Bergrecords",
        comment: "Pressefotos 2017",
        created: "2018-03-16T16:25:37+01:00",
        lastUpdate: "2018-03-16T16:25:37+01:00"
    },
    gallery: [
        {
            id: "93551",
            artistId: "58035",
            url: "http://news.sonymusic.de/PARI/KAT/DOCU0/FOTO3/I/58035-32526I22427.jpg",
            photographer: "© Sony Music",
            comment: "(c) Stephan Pick",
            created: "2018-03-16T16:25:37+01:00",
            lastUpdate: "2019-06-11T13:04:03+02:00"
        },
        {...},
    ]
}
Request:
GET http://api.sonymusic.de/DE/product/88697769762



Response: details of the product
{
      "id": "88875050342",
      "country": "DE",
      "artistId": "6257",
      "artistName": null,
      "ean": "888750503428",
      "title": "Tabaluga - Es lebe die Freundschaft!",
      "releaseType": "Longplay",
      "mediaType": "CD",
      "releaseDate": "2015-10-30",
      "artwork": "http:\/\/news.sonymusic.de\/\/PARI\/KAT\/COVER1\/JPG300X300DPI2\/P\/88875050342.jpg",
      "purchase": [
        {
          "id": "azn_B014Z88N3I",
          "type": "physical",
          "url": "https:\/\/www.amazon.de\/Tabaluga-Es-Lebe-Die-Freundschaft...",
          "created": "2016-10-29T22:21:11+02:00",
          "lastUpdate": "2016-10-29T22:21:11+02:00"
        }
      ],
      "description": "Tabaluga ist das erfolgreichste Konzeptthema Deutschlands! ...",
      "productFamilyId": "3241812",
      "prio": "3",
      "artistNameIndex": "Maffay, Peter",
      "artistNamePhononet": "Peter Maffay",
      "titlePhononet": "Tabaluga - Es lebe die Freundschaft!",
      "objectCount": "1",
      "recordingMediumID": "31",
      "recordingMediumLabel": "CD Longplay",
      "raasUpcCode": "2",
      "labelID": "2627",
      "labelLabel": "RCA DEUTSCHLAND MAFFAY",
      "seriesID": "",
      "seriesLabel": "",
}
Request:
GET http://api.sonymusic.de/DE/product/88697769762/tracks



Response: tracks of the product
[
    {
        "id": "50542471420150825",
        "productId": "88875050342",
        "title": "Ouvert\u00fcre",
        "component": "1",
        "side": "A",
        "sequence": "1",
        "skipNo": "1",
        "length": "130",
        "prelisten": "http:\/\/mp31.phononet.de\/sonymusicmp3\/d2\/928\/233\/ZEOPCLXAGHYBRLWOPRZWXKYMECKM.mp3",
        "artistName": "Peter Maffay",
        "composerName": "Peter Hinderth\u00fcr \/ Peter Maffay \/ Katrin Schr\u00f6der \/ Rupert Keplinger",
        "slug": null,
        "genre": null,
        "releaseType": null,
        "language": "-Other",
        "lyrics": null,
        "story": null,
    },
    {...}
]
Request:
GET http://api.sonymusic.de/DE/track/20934582220091208



Response: details of the product
{
	"id": "20934582220091208",
	"title": "Tattoo",
	"productId": "88697769762",
	"component": "1",
	"side": "A",
	"sequence": "1",
	"length": "76",
	"prelisten": "http:\/\/mp31.phononet.de\/sonymusicmp3\/d1\/623\/697\/ZEOPRXCLKMWAYEBOZCKGHMPEXLCK.mp3",
	"artistName": "The Wroclaw Score Orchestra",
	"composerName": "Peter Maffay",
	"slug": null,
	"genre": null,
	"releaseType": null,
	"language": "-Other",
	"lyrics": null,
	"story": null
}
Request:
GET http://api.sonymusic.de/search/__object__/__property__/__searchItem__



Possible __objects__ are:
  • artist
  • product
  • purchase
Response: Search result of the specified object and property
Request:
GET http://api.sonymusic.de/search/artist/__property__/__searchItem__



Response: products of the requested artist
{
    metadata: {
        results_count: 6,
        search_object: "artist",
        searchColumn: "name",
        search_item: "Silbermond",
        search_time: 0.05413699150085449
    },
    data: [
        {
            id: "1042448",
            country: "DE",
            name: "Curse mit Silbermond",
            biography: "",
            created: "2019-01-15 02:25:55",
            lastUpdate: "2019-01-15 02:25:55",
            indexName: "Curse mit Silbermond"
        },
        {
            id: "1042448",
            country: "DE",
            name: "Silbermond",
            biography: "Nach mehr als 5 Millionen verkauften ...",
            created: "2020-01-12 02:25:55",
            lastUpdate: "2020-01-13 02:54:21",
            indexName: "Silbermond"
        },
        {...}
    ]
}
Request:
GET http://api.sonymusic.de/search/product/__property__/__searchItem__



Response: products of the requested artist
{
    metadata: {
        results_count: 385,
        search_object: "product",
        searchColumn: "artistId",
        search_item: "329963",
        search_time: 0.5320868492126465
    },
    data: [
        {
            id: "G010003420350L",
            country: "AT",
            artistId: "329963",
            artistName: "Silbermond",
            ean: "886445518429",
            title: "Himmel auf",
            releaseType: "Longplay",
            mediaType: "CD",
            releaseDate: "2016-05-20 00:00:00",
            artwork: null,
            purchase: null,
            description: null,
            productFamilyId: "3454111",
            prio: "251",
            artistNameIndex: "Silbermond",
            artistNamePhononet: "Silbermond",
            titlePhononet: "Himmel auf",
            objectCount: "2",
            recordingMediumID: "C1",
            recordingMediumLabel: "Digital Combo Longplay",
            raasUpcCode: "5",
            features: "",
            repertoireCode: "143",
            repertoireLabel: "Pop deutschsprachig",
            labelID: "332",
            labelLabel: "SONY MUSIC CATALOG",
            productGroupId: null,
            titleCategoryId: null,
            seriesID: "",
            seriesLabel: "",
            created: null,
            lastUpdate: null
        },
        {...}
    ]
}
Request:
GET http://api.sonymusic.de/search/purchase/__property__/__searchItem__



Response: Search result for purchase links
{
    metadata: {
        results_count: 2,
        search_object: "purchase",
        searchColumn: "resellerProductId",
        search_item: "B000026FAH",
        search_time: 0.04003405570983887
    },
    data: [
        {
            id: "amzn_AT_0035628966728",
            productId: "BD89667",
            country: "AT",
            resellerProductId: "B000026FAH",
            reseller: "Amazon",
            type: "physical",
            url: "https://www.amazon.de/.../purchase-url",
            created: "2018-08-30 00:15:46",
            lastUpdate: "2018-08-30 00:15:46"
        },
        {
            id: "amzn_DE_0035628966728",
            productId: "BD89667",
            country: "DE",
            resellerProductId: "B000026FAH",
            reseller: "Amazon",
            type: "physical",
            url: "https://www.amazon.de/.../purchase-url",
            created: "2018-08-30 00:15:53",
            lastUpdate: "2018-08-30 00:15:53"
        },
        {...},
    ]
}
Request:
GET http://api.sonymusic.de/search/track/__property__/__searchItem__



Response: Search result for tracks
{
    metadata: {
        results_count: 39,
        search_object: "track",
        searchColumn: "title",
        search_item: "nicht%20mein%20Problem",
        search_time: 0.9398441314697266
    },
    data: [
        {
            id: "01149312820090102",
            productId: "88697412372",
            country: "AT",
            title: "Nicht mein Problem",
            component: "1",
            side: "A",
            sequence: "7",
            skipNo: "7",
            length: "230",
            prelisten: "http://mp31.phononet.de/sonymusicmp3/d2/924/353/ZEOPCLXAGRHLYAWBKGMOHEPCKZRL.mp3",
            artistName: "Silbermond feat. Jan Delay",
            composerName: "Stefanie Kloß",
            genre: null,
            language: "-Other",
            lyrics: null,
            story: null,
            created: "2018-03-16 16:46:48",
            lastUpdate: "2018-10-03 03:15:56"
        },
        {...},
    ]
}
Request:
GET http://api.sonymusic.de/search/picture/__property__/__searchItem__



Response: Search result for tracks
{
    metadata: {
        results_count: 66,
        search_object: "picture",
        searchColumn: "artistId",
        search_item: "329111",
        search_time: 0.046324968338012695
    },
    data: [
        {
            id: "100025",
            artistId: "329111",
            country: "DE",
            url: "http://news.sonymusic.de/PARI/KAT/DOCU0/FOTO3/I/329111-34333I24461.jpg",
            photographer: "Foto: Ellen Von Unwerth",
            comments: "\"4\" (2011)",
            background: null,
            visible: "1",
            created: "2018-03-16 16:27:15",
            lastUpdate: "2018-03-16 16:27:15"
        },
        {
            id: "100027",
            artistId: "329111",
            country: "DE",
            url: "http://news.sonymusic.de/PARI/KAT/DOCU0/FOTO3/I/329111-34334I24462.jpg",
            photographer: "Foto: Ellen Von Unwerth",
            comments: "\"4\" (2011)",
            background: null,
            visible: "1",
            created: "2018-03-16 16:27:15",
            lastUpdate: "2018-03-16 16:27:15"
        },
        {...},
    ]
}
Request:
GET http://api.sonymusic.de/[...]



Response: in case of any error, no matter what's wrong
{
	"error": true,
	"code": 0
	"message": "An unknown error occured."
}


Code Reason
0 An error occured but the reason is unclear.
1 Nothing was requested.
2 The requested country was not in the list of allowed countries.
3 No entity was requested.
4 An entity could not be found.
5 An entity node could not be found.
6 No id was specified for a request that require an id.
7 An entity was requested that could not be resolved.
100 Database connection error