Search concert setlists, artists, and venues via the Setlist.fm API. Works out of the box with a shared API key — look up what songs an artist played at any show by artist name, venue, city, or year. Returns full setlist data with song titles, notes, and encores.

Why this API?

No API key needed to start — runs on a shared free-tier key out of the box; pass ?apiKey= with your own free key (register at api.setlist.fm) for your own quota
Four query modes — search setlists by artist/venue/city, search artists, search venues, or get all setlists for an artist by MusicBrainz ID
Rich setlist data — full song-by-song setlists with notes, covers, encores, and tape tracks
Millions of setlists — community-sourced data covering decades of live music history

Endpoints

Endpoint	What it returns
`GET /setlists`	Search setlists by artist name, venue, city, or year
`GET /artists`	Search artists by name — returns MusicBrainz IDs
`GET /venues`	Search venues by name or city
`GET /artist/{mbid}/setlists`	All setlists for a specific artist by MusicBrainz ID

Quick start

GET /setlists?artistName=Radiohead
GET /setlists?artistName=Radiohead&year=2016
GET /setlists?venueName=Red+Rocks&year=2024
GET /setlists?cityName=London&year=2023

GET /artists?artistName=Phish
GET /artist/e01646f2-2a04-450d-8bf2-0d993082e058/setlists

GET /venues?name=Madison+Square
GET /venues?cityName=Chicago&countryCode=US

Parameters

GET /setlists

Parameter	Required	Description
`artistName`	One of these required	Artist name (e.g. `Radiohead`)
`venueName`	One of these required	Venue name (e.g. `Red Rocks Amphitheatre`)
`cityName`	One of these required	City name (e.g. `London`)
`year`	No	Filter by year (e.g. `2024`)
`page`	No	Page number for pagination (default 1)

GET /artists

Parameter	Required	Description
`artistName`	Yes	Artist name to search for
`sort`	No	Sort order (e.g. `relevance`, `name`)
`page`	No	Page number (default 1)

GET /venues

Parameter	Required	Description
`name`	One of these required	Venue name (e.g. `Madison Square Garden`)
`cityName`	One of these required	City name (e.g. `Chicago`)
`countryCode`	No	Accepted and passed through, but currently has no effect on results — a limitation in the Setlist.fm API itself, not this scraper. Use `cityName` to narrow by location.
`page`	No	Page number (default 1)

GET /artist/{mbid}/setlists

Parameter	Required	Description
`mbid` (path)	Yes	MusicBrainz ID — get from `GET /artists`
`page`	No	Page number (default 1)

Every endpoint above also accepts apiKey (optional) — your own free Setlist.fm API key. Omit it to use the shared key; supply your own if you hit the shared quota.

Output fields

Setlist object (all setlist endpoints)

Field	Description
`setlist[].id`	Setlist.fm setlist ID
`setlist[].eventDate`	Date of the show (DD-MM-YYYY)
`setlist[].artist.name`	Artist name
`setlist[].artist.mbid`	MusicBrainz ID
`setlist[].venue.name`	Venue name
`setlist[].venue.city.name`	City
`setlist[].venue.city.country.code`	Country code
`setlist[].sets.set`	Array of sets, each containing an array of song objects
`setlist[].sets.set[].song[].name`	Song title
`setlist[].sets.set[].song[].cover`	Cover attribution if song is a cover
`setlist[].url`	Setlist.fm page URL
`total`	Total matching setlists
`page`	Current page
`itemsPerPage`	Results per page

Latency & caching

Endpoint	Max latency	Cache TTL
`/setlists`, `/artist/{mbid}/setlists`	~2s	1 hour
`/artists`, `/venues`	~2s	24 hours

Subsequent requests within the TTL return instantly from cache.

Error reference

Code	Meaning
`400`	Missing required parameter (no `artistName`/`venueName`/`cityName` for setlists; no `artistName` for artists; no `name`/`cityName` for venues)
`401`	Missing or invalid RapidAPI key
`404`	No results found for the query
`500`	Internal server error (may indicate invalid Setlist.fm API key)
`503`	Shared Setlist.fm API key hit its rate/daily limit — supply your own via `apiKey`

Use cases

Setlist tracking — see exactly what songs an artist played at any show
Concert history — browse an artist's full touring history going back decades
Playlist generation — build Spotify playlists from setlist data
Venue analytics — discover which artists have played a venue and what they performed
Tour recaps — compare setlists across tour dates to see how the show evolved
Fan apps — power setlist-aware features in music discovery or social apps

Direct access via x402

This API also supports x402 — a micropayment protocol for direct, pay-per-request access without a RapidAPI subscription. Pay $0.001 per request in USDC on Base.

GET https://webscrapers.onrender.com/setlistfm/setlists?artistName=Radiohead
GET https://webscrapers.onrender.com/setlistfm/artists?artistName=Phish
GET https://webscrapers.onrender.com/setlistfm/venues?cityName=London

No Setlist.fm API key is required for x402 access either — the shared key is used by default; pass ?apiKey= with your own free key for your own quota. See x402.org for client libraries and documentation.

This API is not affiliated with Setlist.fm. Use responsibly and in accordance with Setlist.fm's terms of service and API usage policies.