/1.0/search/setlists Resource

GET /1.0/search/setlists

Search for setlists.

Request Parameters
name type description default constraints
artistMbid query the artist's Musicbrainz Identifier (mbid)    
artistName query the artist's name    
artistTmid query the artist's Ticketmaster Identifier (tmid)   int
cityId query the city's geoId    
cityName query the name of the city    
countryCode query the country code    
date query the date of the event (format dd-MM-yyyy)    
lastFm query the event's Last.fm Event ID (deprecated)   int
lastUpdated query the date and time (UTC) when this setlist was last updated (format yyyyMMddHHmmss) - either edited or reverted. search will return setlists that were updated on or after this date    
p query the number of the result page 1 int
state query the state    
stateCode query the state code    
tourName query    
venueId query the venue id    
venueName query the name of the venue    
year query the year of the event    
Response Body
media type data type description
application/json setlists (JSON) a list of matching setlists
application/xml setlists (XML)

Example

Request
GET /1.0/search/setlists
Accept: application/json

              
Response
HTTP/1.1 200 OK
Content-Type: application/json

                
{
  "setlist" : [ {
    "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" : { },
      "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" : "...",
      "encore" : 12345,
      "song" : [ { }, { } ]
    } ],
    "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"
  }, {
    "artist" : {
      "mbid" : "...",
      "tmid" : 12345,
      "name" : "...",
      "sortName" : "...",
      "disambiguation" : "...",
      "url" : "..."
    },
    "venue" : {
      "city" : { },
      "url" : "...",
      "id" : "...",
      "name" : "..."
    },
    "tour" : {
      "name" : "..."
    },
    "set" : [ {
      "name" : "...",
      "encore" : 12345,
      "song" : [ { }, { } ]
    }, {
      "name" : "...",
      "encore" : 12345,
      "song" : [ { }, { } ]
    } ],
    "info" : "...",
    "url" : "...",
    "id" : "...",
    "versionId" : "...",
    "eventDate" : "...",
    "lastUpdated" : "..."
  } ],
  "total" : 42,
  "page" : 1,
  "itemsPerPage" : 20
}