setlist.fm /1.0/search/setlists API
The /1.0/search/setlists API from setlist.fm — 1 operation(s) for /1.0/search/setlists.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/setlist-fm-1-0-search-setlists-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
description: 'The setlist.fm API has been designed to give you easy access to setlist data in order to build fancy websites and
other applications.'
version: '1.0'
title: setlist.fm /1.0/search/setlists API
servers:
- url: /rest
tags:
- name: /1.0/search/setlists
paths:
/1.0/search/setlists:
get:
tags:
- /1.0/search/setlists
summary: Search for setlists
description: Search for setlists.
operationId: resource__1.0_search_setlists_getSetlists_GET
parameters:
- name: artistMbid
in: query
description: the artist's Musicbrainz Identifier (mbid)
schema:
type: string
- name: artistName
in: query
description: the artist's name
schema:
type: string
- name: artistTmid
in: query
description: the artist's Ticketmaster Identifier (tmid) (deprecated)
schema:
type: integer
- name: cityId
in: query
description: the city's geoId
schema:
type: string
- name: cityName
in: query
description: the name of the city
schema:
type: string
- name: countryCode
in: query
description: the country code
schema:
type: string
- name: date
in: query
description: the date of the event (format dd-MM-yyyy)
schema:
type: string
- name: lastFm
in: query
description: the event's Last.fm Event ID (deprecated)
schema:
type: integer
- name: lastUpdated
in: query
description: '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'
schema:
type: string
- name: p
in: query
description: the number of the result page
schema:
type: integer
default: '1'
- name: state
in: query
description: the state
schema:
type: string
- name: stateCode
in: query
description: the state code
schema:
type: string
- name: tourName
in: query
description: ''
schema:
type: string
- name: venueId
in: query
description: the venue id
schema:
type: string
- name: venueName
in: query
description: the name of the venue
schema:
type: string
- name: year
in: query
description: the year of the event
schema:
type: string
responses:
'200':
headers: {}
description: Success
content:
application/xml:
schema:
description: ''
$ref: '#/components/schemas/json_Setlists'
application/json:
schema:
description: ''
$ref: '#/components/schemas/json_Setlists'
example:
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
components:
schemas:
json_Tour:
type: object
title: tour
properties:
name:
example: North American Tour 1964
description: The name of the tour.
type: string
example:
name: North American Tour 1964
description: The tour a setlist was a part of.
json_Coords:
type: object
title: coords
properties:
long:
example: -118.3267434
description: The longitude part of the coordinates.
type: number
lat:
example: 34.0983425
description: The latitude part of the coordinates.
type: number
example:
long: -118.3267434
lat: 34.0983425
description: Coordinates of a point on the globe. Mostly used for Cities.
json_Artist:
type: object
title: artist
properties:
mbid:
example: b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d
description: unique Musicbrainz Identifier (MBID), e.g. <em>"b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d"</em>
type: string
tmid:
example: 735610
description: unique Ticket Master Identifier (TMID), e.g. <em>735610</em> (deprecated)
type: number
name:
example: The Beatles
description: the artist's name, e.g. <em>"The Beatles"</em>
type: string
sortName:
example: Beatles, The
description: the artist's sort name, e.g. <em>"Beatles, The"</em> or <em>"Springsteen, Bruce"</em>
type: string
disambiguation:
example: John, Paul, George and Ringo
description: disambiguation to distinguish between artists with same names
type: string
url:
example: https://www.setlist.fm/setlists/the-beatles-23d6a88b.html
description: the attribution url
type: string
example:
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
description: 'This class represents an artist. An artist is a musician or a group of musicians. Each artist has a definite
<a href="http://wiki.musicbrainz.org/MBID">Musicbrainz Identifier</a> (MBID) with which the artist can be uniquely
identified.'
json_Setlists:
type: object
title: setlists
properties:
setlist:
description: result list of setlists
type: array
items:
$ref: '#/components/schemas/json_Setlist'
total:
example: 42
description: the total amount of items matching the query
type: number
page:
example: 1
description: the current page. starts at 1
type: number
itemsPerPage:
example: 20
description: the amount of items you get per page
type: number
example:
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
description: A Result consisting of a list of setlists.
json_Setlist:
type: object
title: setlist
properties:
artist:
description: the setlist's artist
$ref: '#/components/schemas/json_Artist'
venue:
description: the setlist's venue
$ref: '#/components/schemas/json_Venue'
tour:
description: the setlist's tour
$ref: '#/components/schemas/json_Tour'
set:
description: all sets of this setlist
type: array
items:
$ref: '#/components/schemas/json_Set'
info:
example: Recorded and published as 'The Beatles at the Hollywood Bowl'
description: 'additional information on the concert - see the <a href="https://www.setlist.fm/guidelines">setlist.fm
guidelines</a> for a complete list of allowed content.'
type: string
url:
example: https://www.setlist.fm/setlist/the-beatles/1964/hollywood-bowl-hollywood-ca-63de4613.html
description: the attribution url to which you have to link to wherever you use data from this setlist in your application
type: string
id:
example: 63de4613
description: unique identifier
type: string
versionId:
example: 7be1aaa0
description: unique identifier of the version
type: string
lastFmEventId:
example: 1164056
description: the id this event has on <a href="http://last.fm/">last.fm</a> (deprecated)
type: number
eventDate:
example: 23-08-1964
description: date of the concert in the format "dd-MM-yyyy"
type: string
lastUpdated:
example: 2013-10-20T05:18:08.000+0000
description: 'date, time and time zone of the last update to this setlist in the format
"yyyy-MM-dd''T''HH:mm:ss.SSSZZZZZ"'
type: string
example:
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:
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
description: '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
<a href="https://www.setlist.fm/">setlist.fm</a> 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.'
json_Set:
type: object
title: set
properties:
name:
description: 'the description/name of the set. E.g. <em>"Acoustic set"</em> or <em>"Paul McCartney
solo"</em>'
type: string
encore:
description: 'if the set is an encore, this is the number of the encore, starting with 1 for the first encore, 2 for the second
and so on.'
type: number
song:
description: this set's songs
type: array
items:
$ref: '#/components/schemas/json_Song'
example:
name: '...'
encore: 12345
song:
- name: Yesterday
with:
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
cover:
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
info: '...'
tape: false
- name: '...'
with:
mbid: '...'
name: '...'
sortName: '...'
disambiguation: '...'
url: '...'
cover:
mbid: '...'
name: '...'
sortName: '...'
disambiguation: '...'
url: '...'
info: '...'
tape: true
description: 'A setlist consists of different (at least one) sets. Sets can either be sets as defined in the
<a href="https://www.setlist.fm/guidelines">Guidelines</a> or encores.'
json_Song:
type: object
title: song
properties:
name:
example: Yesterday
description: The name of the song. E.g. <em>Yesterday</em> or <em>"Wish You Were Here"</em>
type: string
with:
description: A different Artist than the performing one that joined the stage for this song.
$ref: '#/components/schemas/json_Artist'
cover:
description: The original Artist of this song, if different to the performing artist.
$ref: '#/components/schemas/json_Artist'
info:
description: 'Special incidents or additional information about the way the song was performed at this specific concert. See
the <a href="https://www.setlist.fm/guidelines">setlist.fm guidelines</a> for a complete list of allowed content.'
type: string
tape:
example: false
description: 'The song came from tape rather than being performed live. See the
<a href="https://www.setlist.fm/guidelines#tape-songs">tape section of the guidelines</a> for valid usage.'
type: boolean
example:
name: Yesterday
with:
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
cover:
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
info: '...'
tape: false
description: This class represents a song that is part of a Set.
json_City:
type: object
title: city
properties:
id:
example: '5357527'
description: unique identifier
type: string
name:
example: Hollywood
description: 'the city''s name, depending on the language valid values are e.g. <em>"Müchen"</em> or
<em>Munich</em>'
type: string
stateCode:
example: CA
description: 'The code of the city''s state. For most countries this is a two-digit numeric code, with which the state can be
identified uniquely in the specific Country. The code can also be a String for other cities. Valid
examples are <em>"CA"</em> or <em>"02"</em>
which in turn get uniquely identifiable when combined with the state''s country:
<em>"US.CA"</em> for California, United States or <em>"DE.02"</em> for Bavaria, Germany
For a complete list of available states (that aren''t necessarily used in this database) is available in
<a href= "http://download.geonames.org/export/dump/admin1CodesASCII.txt">a textfile on geonames.org</a>.
Note that this code is only unique combined with the city''s Country. The code alone is
<strong>not</strong> unique.'
type: string
state:
example: California
description: The name of city's state, e.g. <em>"Bavaria"</em> or <em>"Florida"</em>
type: string
coords:
description: The city's coordinates. Usually the coordinates of the city centre are used.
$ref: '#/components/schemas/json_Coords'
country:
description: The city's country.
$ref: '#/components/schemas/json_Country'
example:
id: '5357527'
name: Hollywood
stateCode: CA
state: California
coords:
long: -118.3267434
lat: 34.0983425
country:
code: US
name: United States
description: 'This class represents a city where Venues are located. Most of the original city data was taken from
<a href="http://geonames.org/">Geonames.org</a>.'
json_Venue:
type: object
title: venue
properties:
city:
description: the city in which the venue is located
$ref: '#/components/schemas/json_City'
url:
example: https://www.setlist.fm/venue/compaq-center-san-jose-ca-usa-6bd6ca6e.html
description: the attribution url
type: string
id:
example: 6bd6ca6e
description: unique identifier
type: string
name:
example: Compaq Center
description: 'the name of the venue, usually without city and country. E.g. <em>"Madison Square Garden"</em> or
<em>"Royal Albert Hall"</em>'
type: string
example:
city:
id: '5357527'
name: Hollywood
stateCode: CA
state: California
coords:
long: -118.3267434
lat: 34.0983425
country:
code: US
name: United States
url: https://www.setlist.fm/venue/compaq-center-san-jose-ca-usa-6bd6ca6e.html
id: 6bd6ca6e
name: Compaq Center
description: 'Venues are places where concerts take place. They usually consist of a venue name and a city - but there are also
some venues that do not have a city attached yet. In such a case, the city simply isn''t set and the city and country
may (but do not have to) be in the name.'
json_Country:
type: object
title: country
properties:
code:
example: US
description: 'The country''s <a href= "http://www.iso.org/iso/english_country_names_and_code_elements" >ISO code</a>. E.g.
<em>"ie"</em> for Ireland'
type: string
name:
example: United States
description: 'The country''s name. Can be a localized name - e.g. <em>"Austria"</em> or
<em>"Österreich"</em> for Austria if the German name was requested.'
type: string
example:
code: US
name: United States
description: This class represents a country on earth.