Setlists, that's what it's all about. So if you're trying to use this API without knowing what a setlist is then you're kinda wrong on this page ;-). A setlist can be distinguished from other setlists by its unique id. But as setlist.fm works the wiki way, there can be different versions of one setlist (each time a user updates a setlist a new version gets created). These different versions have a unique id on its own. So setlists can have the same id although they differ as far as the content is concerned - thus the best way to check if two setlists are the same is to compare their versionIds.
name | data type | description |
---|---|---|
artist | artist | the setlist's artist |
venue | venue | the setlist's venue |
tour | tour | the setlist's tour |
set | array of set | all sets of this setlist |
info | string | additional information on the concert - see the setlist.fm guidelines for a complete list of allowed content. |
url | string | the attribution url to which you have to link to wherever you use data from this setlist in your application |
id | string | unique identifier |
versionId | string | unique identifier of the version |
|
|
|
eventDate | string | date of the concert in the format "dd-MM-yyyy" |
lastUpdated | string | date, time and time zone of the last update to this setlist in the format "yyyy-MM-dd'T'HH:mm:ss.SSSZZZZZ" |
Example
{ "artist" : { "mbid" : "b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d", "tmid" : 735610, "name" : "The Beatles", "sortName" : "Beatles, The", "disambiguation" : "John, Paul, George and Ringo", "url" : "https://www.setlist.fm/setlists/the-beatles-23d6a88b.html" }, "venue" : { "city" : { "id" : "5357527", "name" : "Hollywood", "stateCode" : "CA", "state" : "California", "coords" : { }, "country" : { } }, "url" : "https://www.setlist.fm/venue/compaq-center-san-jose-ca-usa-6bd6ca6e.html", "id" : "6bd6ca6e", "name" : "Compaq Center" }, "tour" : { "name" : "North American Tour 1964" }, "set" : [ { "name" : "...", "encore" : 12345, "song" : [ { "name" : "Yesterday", "with" : { }, "cover" : { }, "info" : "...", "tape" : false }, { "name" : "...", "with" : { }, "cover" : { }, "info" : "...", "tape" : true } ] }, { "name" : "...", "encore" : 12345, "song" : [ { "name" : "...", "with" : { }, "cover" : { }, "info" : "...", "tape" : true }, { "name" : "...", "with" : { }, "cover" : { }, "info" : "...", "tape" : true } ] } ], "info" : "Recorded and published as 'The Beatles at the Hollywood Bowl'", "url" : "https://www.setlist.fm/setlist/the-beatles/1964/hollywood-bowl-hollywood-ca-63de4613.html", "id" : "63de4613", "versionId" : "7be1aaa0", "eventDate" : "23-08-1964", "lastUpdated" : "2013-10-20T05:18:08.000+0000" }