setlist.fm Setlists API
Individual setlists and their historical versions.
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-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:
title: setlist.fm REST Setlists API
description: The setlist.fm REST API provides read-only access to the world's largest crowd-sourced concert setlist database.
version: '1.0'
contact:
name: setlist.fm
url: https://api.setlist.fm/docs/1.0/index.html
termsOfService: https://www.setlist.fm/help/terms
servers:
- url: https://api.setlist.fm/rest/1.0
description: setlist.fm REST API v1.0
security:
- apiKeyAuth: []
tags:
- name: Setlists
description: Individual setlists and their historical versions.
paths:
/setlist/{setlistId}:
get:
operationId: getSetlist
tags:
- Setlists
summary: Get a setlist
description: Returns the current version of a setlist for a given setlist ID.
parameters:
- name: setlistId
in: path
required: true
description: The setlist ID.
schema:
type: string
responses:
'200':
description: The requested setlist.
content:
application/json:
schema:
$ref: '#/components/schemas/Setlist'
'404':
$ref: '#/components/responses/NotFound'
/setlist/version/{versionId}:
get:
operationId: getSetlistVersion
tags:
- Setlists
summary: Get a setlist by version
description: Returns a specific historical version of a setlist. Setlists are crowd-edited; each edit produces a new immutable version identified by a version ID.
parameters:
- name: versionId
in: path
required: true
description: The version ID of the setlist.
schema:
type: string
responses:
'200':
description: The requested setlist version.
content:
application/json:
schema:
$ref: '#/components/schemas/Setlist'
'404':
$ref: '#/components/responses/NotFound'
components:
schemas:
Song:
type: object
properties:
name:
type: string
info:
type: string
cover:
$ref: '#/components/schemas/Artist'
tape:
type: boolean
Artist:
type: object
properties:
mbid:
type: string
description: Unique MusicBrainz Identifier of the artist.
name:
type: string
sortName:
type: string
disambiguation:
type: string
url:
type: string
format: uri
description: The setlist.fm page of the artist.
Country:
type: object
properties:
code:
type: string
description: The ISO code of the country.
name:
type: string
Sets:
type: object
properties:
set:
type: array
items:
$ref: '#/components/schemas/Set'
Tour:
type: object
properties:
name:
type: string
City:
type: object
properties:
id:
type: string
description: The GeoNames geoId.
name:
type: string
stateCode:
type: string
state:
type: string
coords:
$ref: '#/components/schemas/Coords'
country:
$ref: '#/components/schemas/Country'
Coords:
type: object
properties:
lat:
type: number
format: double
long:
type: number
format: double
Venue:
type: object
properties:
id:
type: string
name:
type: string
url:
type: string
format: uri
city:
$ref: '#/components/schemas/City'
Error:
type: object
properties:
code:
type: integer
status:
type: string
message:
type: string
timestamp:
type: string
Set:
type: object
properties:
name:
type: string
encore:
type: integer
song:
type: array
items:
$ref: '#/components/schemas/Song'
Setlist:
type: object
properties:
id:
type: string
versionId:
type: string
eventDate:
type: string
description: The date of the concert (format dd-MM-yyyy).
lastUpdated:
type: string
format: date-time
artist:
$ref: '#/components/schemas/Artist'
venue:
$ref: '#/components/schemas/Venue'
tour:
$ref: '#/components/schemas/Tour'
sets:
$ref: '#/components/schemas/Sets'
info:
type: string
url:
type: string
format: uri
responses:
NotFound:
description: The requested resource was not found.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: API key issued from https://www.setlist.fm/settings/api. Passed in the `x-api-key` request header on every call.