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 | type | namespace | min/max occurs | constraints | wrapped by | description |
---|---|---|---|---|---|---|---|
lastUpdated | string | attribute | 1/1 | date, time and time zone of the last update to this setlist in the format "yyyy-MM-dd'T'HH:mm:ss.SSSZZZZZ" | |||
versionId | string | attribute | 1/1 | unique identifier of the version | |||
|
|
|
|
|
|
|
|
id | string | attribute | 1/1 | unique identifier | |||
eventDate | string | attribute | 1/1 | date of the concert in the format "dd-MM-yyyy" | |||
artist | artist | element | 1/1 | required | the setlist's artist | ||
venue | venue | element | 1/1 | required | the setlist's venue | ||
tour | tour | element | 0/1 | the setlist's tour | |||
set | set | element | 0/unbounded | sets | all sets of this setlist | ||
info | string | element | 0/1 | additional information on the concert - see the setlist.fm guidelines for a complete list of allowed content. | |||
url | string | element | 1/1 | required | the attribution url to which you have to link to wherever you use data from this setlist in your application |
Example
<setlist eventDate="23-08-1964" id="63de4613" lastUpdated="2013-10-20T05:18:08.000+0000" versionId="7be1aaa0"> <artist disambiguation="John, Paul, George and Ringo" mbid="b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d" name="The Beatles" sortName="Beatles, The" tmid="735610"> <url>https://www.setlist.fm/setlists/the-beatles-23d6a88b.html</url> </artist> <venue id="6bd6ca6e" name="Compaq Center"> <city id="5357527" name="Hollywood" state="California" stateCode="CA"> <coords/> <country/> </city> <url>https://www.setlist.fm/venue/compaq-center-san-jose-ca-usa-6bd6ca6e.html</url> </venue> <tour name="North American Tour 1964"/> <sets> <set encore="..." name="..."> <song name="Yesterday" tape="false"> <with/> <cover/> <info>...</info> </song> </set> </sets> <info>Recorded and published as 'The Beatles at the Hollywood Bowl'</info> <url>https://www.setlist.fm/setlist/the-beatles/1964/hollywood-bowl-hollywood-ca-63de4613.html</url> </setlist>