Setlist.fm Scraper

Scrape concert setlists from Setlist.fm — the world's largest user-contributed concert setlist database. Find setlists by artist, fetch specific concerts by URL, or collect an artist's full concert history.

No API key or login required. Uses public HTML pages only.

---

What You Can Scrape

• Search Setlists — find setlists by searching any artist name
• Fetch by URL — scrape specific setlists by providing their setlist.fm URLs
• Artist Setlists — get all available setlists for a specific artist

---

Input Parameters

Field	Type	Description
mode	Select	Scraping mode — see modes below
searchQuery	Text	Artist name to search for (modes: searchSetlists, artistSetlists)
setlistUrls	List	One or more setlist.fm URLs (mode: byUrl)
artistUrl	Text	Artist page URL on setlist.fm (mode: artistSetlists)
maxItems	Number	Maximum number of setlists to return (default: 20, max: 500)

Modes

Mode	Description
searchSetlists	Search setlists by artist name — returns the most relevant results
byUrl	Fetch one or more specific setlists by providing their setlist.fm URLs
artistSetlists	Fetch all setlists for an artist by artist page URL or name (paginates through all pages)

---

Output Fields

Field	Type	Description
setlistId	String	Unique hex ID from the setlist URL
setlistUrl	String	Full URL to the setlist on setlist.fm
artistName	String	Artist/band name
artistMbid	String	MusicBrainz ID (when available from artist page URL)
eventDate	String	Concert date in ISO format (YYYY-MM-DD)
year	Number	Year of the concert
venue	String	Venue name
city	String	City where the concert took place
country	String	Country of the concert
countryCode	String	ISO 2-letter country code (e.g. US, GB)
tourName	String	Tour name (if part of a named tour)
festivalName	String	Festival name (if it was a festival show)
isFestival	Boolean	Whether the concert was a festival performance
songs	Array	List of song titles performed (in order)
songCount	Number	Total number of songs performed
setCount	Number	Number of sets (including encores)
hasEncore	Boolean	Whether the show included an encore
scrapedAt	String	ISO timestamp of when data was collected

---

Example Usage

Search for Radiohead setlists

{
  "mode": "searchSetlists",
  "searchQuery": "Radiohead",
  "maxItems": 20
}

Example output record:

{
  "setlistId": "23ef45ab",
  "setlistUrl": "https://www.setlist.fm/setlist/radiohead/2016/td-garden-boston-ma-us-23ef45ab.html",
  "artistName": "Radiohead",
  "eventDate": "2016-08-10",
  "year": 2016,
  "venue": "TD Garden",
  "city": "Boston",
  "country": "United States",
  "tourName": "A Moon Shaped Pool Tour",
  "isFestival": false,
  "songs": ["Burn the Witch", "Daydreaming", "Decks Dark", "Desert Island Disk", "Ful Stop", "Glass Eyes"],
  "songCount": 26,
  "setCount": 2,
  "hasEncore": true,
  "scrapedAt": "2026-05-01T12:00:00+00:00"
}

Fetch specific setlists by URL

{
  "mode": "byUrl",
  "setlistUrls": [
    "https://www.setlist.fm/setlist/radiohead/2016/td-garden-boston-ma-us-23ef45ab.html",
    "https://www.setlist.fm/setlist/nirvana/1993/seattle-center-arena-seattle-wa-us-43c15c11.html"
  ]
}

Get all setlists for an artist

{
  "mode": "artistSetlists",
  "artistUrl": "https://www.setlist.fm/setlists/radiohead-3d6bfb4f.html",
  "maxItems": 100
}

Or use searchQuery to auto-find the artist page:

{
  "mode": "artistSetlists",
  "searchQuery": "Pink Floyd",
  "maxItems": 50
}

---

Finding Artist Page URLs

1. Go to setlist.fm and search for your artist
2. Click on the artist name to go to their setlists page
3. Copy the URL — it looks like: https://www.setlist.fm/setlists/radiohead-3d6bfb4f.html
4. Use that URL in the artistUrl input field

Alternatively, just use searchQuery with mode=artistSetlists and the actor will find the artist page automatically.

---

Understanding the Setlist ID

Each setlist URL contains a unique hex ID at the end:

https://www.setlist.fm/setlist/radiohead/2016/td-garden-boston-ma-us-23ef45ab.html
                                                                             ^^^^^^^^
                                                                            setlistId

This ID (23ef45ab) is extracted into the setlistId output field.

---

Frequently Asked Questions

Does this require a Setlist.fm API key?
No. This scraper uses the public setlist.fm website HTML — no API key or account required.

How many setlists can I collect per run?
Up to 500 setlists per run (configurable via maxItems). For larger collections, run the actor multiple times.

Why might some song lists be incomplete?
Setlist.fm is user-contributed. Some setlists have incomplete song lists, or only show a summary. The actor fetches detail pages to maximize song data.

What's the difference between searchSetlists and artistSetlists?
searchSetlists returns the most relevant search results for an artist name. artistSetlists paginates through an artist's complete concert history. Use artistSetlists when you need all available concerts.

Can I search by song name?
Currently, searching is by artist name only. Setlist.fm's search is artist-focused.

Are festival appearances included?
Yes — the isFestival field indicates if a show was a festival performance, and festivalName contains the festival name.

What data is available for each setlist?
Artist name, concert date, venue, city/country, tour name, song list (in order), encore information, and a direct URL to the setlist page.

---

Data Source

This actor scrapes the public website https://www.setlist.fm, which hosts the world's largest collection of user-contributed concert setlists. Data accuracy depends on user contributions. Please respect setlist.fm's terms of service and use responsibly.