Setlist.fm Scraper

Fetch concert setlists, artist discographies, and venue information from Setlist.fm — the world's largest community-maintained database of live concert setlists.

What it does

This scraper gives you programmatic access to Setlist.fm's database of millions of live concert setlists. You can:

• Search setlists by artist name, city, venue, or year
• Look up every song an artist has played live
• Find all artists who have played in a specific city or venue
• Pull the full setlist history for any artist using their MusicBrainz ID

Why use it

Concert tracking — Find out exactly what songs an artist played on a specific tour date.

Setlist history — Research an artist's full live catalogue: which songs get played most often, which are rarities, how setlists evolved over years.

Venue research — See every act that has performed at a venue and when.

Fan data — Build apps for concert-goers: "did they play my favourite song?", set length averages, tour route maps.

---

Setup

You need a free Setlist.fm API key. Register at api.setlist.fm. Provide it as the apiKey input field or set the SETLISTFM_API_KEY environment variable.

---

Input

Field	Type	Required	Description
apiKey	string	Yes (or env var)	Your Setlist.fm API key
queryType	string	No (default: search-setlists)	What to fetch — see options below
artistName	string	Depends	Artist/band name. Required for search-artists. Filter for search-setlists.
mbid	string	For artist-setlists	Artist MusicBrainz ID (e.g. 3bd6bf59-a9ad-4e2c-b7ef-81c1e62a78ec)
venueName	string	No	Filter search-setlists by venue name
name	string	For search-venues	Venue name to search
cityName	string	No	Filter by city (e.g. New York, London)
countryCode	string	No	ISO country code filter for search-venues (e.g. US, GB)
year	integer	No	Filter search-setlists by year (e.g. 2024)
sort	string	No	Sort order for artist results: sortName or relevance
page	integer	No (default: 1)	Page number for pagination

Query types

queryType	What it fetches
search-setlists	Setlists matching artist, venue, city, and/or year filters
search-artists	Artists matching a name (requires artistName)
search-venues	Venues matching a name or city
artist-setlists	All setlists for a specific artist by MBID

---

Output

Each dataset item is a setlist, artist, or venue record depending on queryType.

Setlist fields (search-setlists, artist-setlists)

Field	Description
queryType	The query type used
eventDate	Concert date in DD-MM-YYYY format
artist	Object with name, mbid, url
venue	Object with name, city (name, state, coords), country
sets	Object containing set array — each set has song array with name, tape, cover
url	Direct link to this setlist on Setlist.fm

Artist fields (search-artists)

Field	Description
name	Artist name
mbid	MusicBrainz ID — use this for artist-setlists queries
url	Artist page on Setlist.fm

Venue fields (search-venues)

Field	Description
name	Venue name
city	City object with name, state, stateCode, coords, country
url	Venue page on Setlist.fm

---

Usage examples

Find Radiohead setlists from 2016

{
  "apiKey": "YOUR_KEY",
  "queryType": "search-setlists",
  "artistName": "Radiohead",
  "year": 2016
}

Find all setlists at Madison Square Garden

{
  "apiKey": "YOUR_KEY",
  "queryType": "search-setlists",
  "venueName": "Madison Square Garden"
}

Get Radiohead's MBID first, then pull their full setlist history

Step 1:

{
  "apiKey": "YOUR_KEY",
  "queryType": "search-artists",
  "artistName": "Radiohead"
}

Step 2 (using the mbid from step 1):

{
  "apiKey": "YOUR_KEY",
  "queryType": "artist-setlists",
  "mbid": "3bd6bf59-a9ad-4e2c-b7ef-81c1e62a78ec"
}

Find venues in Berlin

{
  "apiKey": "YOUR_KEY",
  "queryType": "search-venues",
  "cityName": "Berlin",
  "countryCode": "DE"
}

---

Use cases

• Concert apps — Let users browse past shows for their favourite artists
• Tour research — Map every city an artist visited on a specific tour
• Setlist statistics — Calculate song frequency, average set length, opening/closing songs
• Ticket buyer research — See what songs to expect before attending a show
• Music journalism — Pull historical setlist data for artist profiles and retrospectives