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. Works out of the box with a shared API key — bring your own free key only if you need higher quota.

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

No API key needed to start — runs on a shared free-tier key out of the box. If you hit the shared quota, register a free key at api.setlist.fm and provide it via the apiKey input field to use your own quota instead.

---

Input

Field	Type	Required	Description
apiKey	string	Optional	Your own free Setlist.fm API key. Omit to use the shared key; supply your own if you hit the shared quota.
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	Accepted and passed through, but currently has no effect on results — a limitation in the Setlist.fm API itself. Use cityName to narrow by location.
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

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

Find all setlists at Madison Square Garden

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

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

Step 1:

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

Step 2 (using the mbid from step 1):

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

Find venues in Berlin

{
  "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