v1

latestSwagger 2.02026-07-13153383.1 KB

/1.0/search/setlists

Search for setlists.

get/1.0/search/setlists

Query parameters

artistMbidstring

the artist's Musicbrainz Identifier (mbid)

artistNamestring

the artist's name

artistTmidinteger

the artist's Ticketmaster Identifier (tmid) (deprecated)

cityIdstring

the city's geoId

cityNamestring

the name of the city

countryCodestring

the country code

datestring

the date of the event (format dd-MM-yyyy)

lastFminteger

the event's Last.fm Event ID (deprecated)

lastUpdatedstring

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

pinteger

the number of the result page

statestring

the state

stateCodestring

the state code

tourNamestring

venueIdstring

the venue id

venueNamestring

the name of the venue

yearstring

the year of the event

Response

Success

totalnumber

the total amount of items matching the query

pagenumber

the current page. starts at 1

itemsPerPagenumber

the amount of items you get per page

Example response

{
  "setlist": [
    {
      "artist": {
        "mbid": "b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d",
        "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": "...",
        "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
}