Pricing
from $1.00 / 1,000 results
Setlist.fm Scraper
Fetch setlists, artists, and venues from Setlist.fm — track concert history and song choices for any artist.
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
Find all setlists at Madison Square Garden
Get Radiohead's MBID first, then pull their full setlist history
Step 1:
Step 2 (using the mbid from step 1):
Find venues in Berlin
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
