setlist.fm

setlist.fm is the world's largest crowd-sourced concert setlist database and community, letting fans document, share, and explore which songs artists play at live shows. The setlist.fm REST API gives read-only access to that data - artists (keyed by MusicBrainz MBID), setlists and their revision history, venues, cities, and countries, plus full-text search across each - so developers can build music apps, tour trackers, and research tools. setlist.fm is owned by Live Nation Entertainment through its Ticketmaster subsidiary. The API is free for non-commercial use with an API key; commercial use requires contacting setlist.fm.

7 APIs 0 Features
MusicConcertsSetlistsLive MusicDatabaseCrowd-SourcedEntertainment

APIs

setlist.fm Artists API

Look up an artist by their MusicBrainz identifier (MBID) and page through every setlist attributed to that artist. Artists are the primary entry point for exploring a performer'...

setlist.fm Setlists API

Retrieve a single concert setlist by its ID - the ordered songs, sets, encores, tour, artist, and venue - or fetch a specific historical revision of a setlist by its version ID,...

setlist.fm Venues API

Look up a venue by its setlist.fm venue ID and page through all setlists performed at that venue. Venues carry the city, and through the city the state, country, and geo-coordin...

setlist.fm Cities API

Resolve a city by its GeoNames geoId to get its name, state, country, and latitude/longitude. Most of setlist.fm's city data originates from Geonames.org and is the geographic b...

setlist.fm Countries API

Return the complete list of countries setlist.fm knows about, each with its ISO country code and localized name. This is the reference set used to constrain and interpret geogra...

setlist.fm Search API

Full-text and faceted search across artists, venues, cities, and setlists. Filter setlists by artist, venue, city, country, tour, date, and song, with paginated results - the ma...

setlist.fm User API

Look up a community member by user ID and retrieve the concerts they have marked as attended or the setlists they have edited. Surfaces the crowd-sourced contributions that keep...

Collections

setlist.fm REST API

OPEN

Pricing Plans

Setlistfm Plans Pricing

3 plans

PLANS

Rate Limits

Setlistfm Rate Limits

3 limits

RATE LIMITS

FinOps

Setlistfm Finops

FINOPS

Resources

🔗
DomainSecurity
DomainSecurity
🔑
Authentication
Authentication
🔗
LinkedIn
LinkedIn
🔗
Website
Website
🔗
Documentation
Documentation
🔗
Plans
Plans
🔗
RateLimits
RateLimits
🔗
FinOps
FinOps

Sources

Raw ↑ 
opencollection: 1.0.0
info:
  name: setlist.fm REST API
  version: '1.0'
request:
  auth:
    type: apikey
    apikey:
      key: x-api-key
      value: '{{apiKey}}'
      in: header
items:
- info:
    name: Artists
    type: folder
  items:
  - info:
      name: Get an artist.
      type: http
    http:
      method: GET
      url: https://api.setlist.fm/rest/1.0/artist/:mbid
      headers:
      - name: Accept
        value: application/json
      params:
      - name: mbid
        value: 0bfba3d3-6a04-4779-bb0a-df07df5b0558
        type: path
        description: The artist's MusicBrainz MBID.
    docs: Returns an artist for a given MusicBrainz MBID.
  - info:
      name: Get an artist's setlists.
      type: http
    http:
      method: GET
      url: https://api.setlist.fm/rest/1.0/artist/:mbid/setlists?p=1
      headers:
      - name: Accept
        value: application/json
      params:
      - name: mbid
        value: 0bfba3d3-6a04-4779-bb0a-df07df5b0558
        type: path
        description: The artist's MusicBrainz MBID.
      - name: p
        value: '1'
        type: query
        description: The result page number.
    docs: Returns a paginated list of the setlists of a given artist.
- info:
    name: Setlists
    type: folder
  items:
  - info:
      name: Get a setlist.
      type: http
    http:
      method: GET
      url: https://api.setlist.fm/rest/1.0/setlist/:setlistId
      headers:
      - name: Accept
        value: application/json
      params:
      - name: setlistId
        value: ''
        type: path
        description: The setlist ID.
    docs: Returns the current version of a setlist for a given setlist ID.
  - info:
      name: Get a setlist by version.
      type: http
    http:
      method: GET
      url: https://api.setlist.fm/rest/1.0/setlist/version/:versionId
      headers:
      - name: Accept
        value: application/json
      params:
      - name: versionId
        value: ''
        type: path
        description: The version ID of the setlist.
    docs: Returns a specific historical version of a setlist by its version ID.
- info:
    name: Venues
    type: folder
  items:
  - info:
      name: Get a venue.
      type: http
    http:
      method: GET
      url: https://api.setlist.fm/rest/1.0/venue/:venueId
      headers:
      - name: Accept
        value: application/json
      params:
      - name: venueId
        value: ''
        type: path
        description: The venue ID.
    docs: Returns a venue for a given venue ID.
  - info:
      name: Get a venue's setlists.
      type: http
    http:
      method: GET
      url: https://api.setlist.fm/rest/1.0/venue/:venueId/setlists?p=1
      headers:
      - name: Accept
        value: application/json
      params:
      - name: venueId
        value: ''
        type: path
        description: The venue ID.
      - name: p
        value: '1'
        type: query
        description: The result page number.
    docs: Returns a paginated list of the setlists performed at a given venue.
- info:
    name: Cities
    type: folder
  items:
  - info:
      name: Get a city.
      type: http
    http:
      method: GET
      url: https://api.setlist.fm/rest/1.0/city/:geoId
      headers:
      - name: Accept
        value: application/json
      params:
      - name: geoId
        value: '5357527'
        type: path
        description: The GeoNames geoId of the city.
    docs: Returns a city for a given GeoNames geoId.
- info:
    name: Countries
    type: folder
  items:
  - info:
      name: Get all countries.
      type: http
    http:
      method: GET
      url: https://api.setlist.fm/rest/1.0/search/countries
      headers:
      - name: Accept
        value: application/json
    docs: Returns the complete list of countries known to setlist.fm.
- info:
    name: Search
    type: folder
  items:
  - info:
      name: Search for artists.
      type: http
    http:
      method: GET
      url: https://api.setlist.fm/rest/1.0/search/artists?artistName=Radiohead&p=1&sort=relevance
      headers:
      - name: Accept
        value: application/json
      params:
      - name: artistName
        value: Radiohead
        type: query
        description: The artist's name.
      - name: p
        value: '1'
        type: query
        description: The result page number.
      - name: sort
        value: relevance
        type: query
        description: sortName or relevance.
    docs: Search for artists by name, MBID, or Ticket Master ID.
  - info:
      name: Search for venues.
      type: http
    http:
      method: GET
      url: https://api.setlist.fm/rest/1.0/search/venues?name=Madison Square Garden&p=1
      headers:
      - name: Accept
        value: application/json
      params:
      - name: name
        value: Madison Square Garden
        type: query
        description: Name of the venue.
      - name: p
        value: '1'
        type: query
        description: The result page number.
    docs: Search for venues by name, city, state, or country.
  - info:
      name: Search for cities.
      type: http
    http:
      method: GET
      url: https://api.setlist.fm/rest/1.0/search/cities?name=New York&p=1
      headers:
      - name: Accept
        value: application/json
      params:
      - name: name
        value: New York
        type: query
        description: Name of the city.
      - name: p
        value: '1'
        type: query
        description: The result page number.
    docs: Search for cities by name, country, state, or state code.
  - info:
      name: Search for setlists.
      type: http
    http:
      method: GET
      url: https://api.setlist.fm/rest/1.0/search/setlists?artistName=Radiohead&year=2023&p=1
      headers:
      - name: Accept
        value: application/json
      params:
      - name: artistName
        value: Radiohead
        type: query
        description: The artist's name.
      - name: year
        value: '2023'
        type: query
        description: The year of the event.
      - name: p
        value: '1'
        type: query
        description: The result page number.
    docs: Search for setlists filtered by artist, venue, city, country, tour, date, and song.
- info:
    name: User
    type: folder
  items:
  - info:
      name: Get a user.
      type: http
    http:
      method: GET
      url: https://api.setlist.fm/rest/1.0/user/:userId
      headers:
      - name: Accept
        value: application/json
      params:
      - name: userId
        value: ''
        type: path
        description: The user ID.
    docs: Returns a user for a given user ID.
  - info:
      name: Get concerts a user attended.
      type: http
    http:
      method: GET
      url: https://api.setlist.fm/rest/1.0/user/:userId/attended?p=1
      headers:
      - name: Accept
        value: application/json
      params:
      - name: userId
        value: ''
        type: path
        description: The user ID.
      - name: p
        value: '1'
        type: query
        description: The result page number.
    docs: Returns a paginated list of setlists a user has marked as attended.
  - info:
      name: Get setlists a user edited.
      type: http
    http:
      method: GET
      url: https://api.setlist.fm/rest/1.0/user/:userId/edited?p=1
      headers:
      - name: Accept
        value: application/json
      params:
      - name: userId
        value: ''
        type: path
        description: The user ID.
      - name: p
        value: '1'
        type: query
        description: The result page number.
    docs: Returns a paginated list of setlists a user has edited.
bundled: true