Reef AI: ask for any data. Try it
Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the setlist.fm API page →
docs / setlistfm

setlist.fm

setlist.fm concert setlists as JSON: search by artist, venue, city, country, tour, song, date or attendee; every song in order with covers, guests, tape and encores; song, tour and album statistics, average setlists, venues, cities, festivals and user profiles.

base /setlistfm/v116 endpoints
post/setlistfm/v1/setlist1 credit

One setlist in full: date, artist, venue (+ city, state, country), tour, festival, set times (doors, scheduled, start, end + the tour's averages), every set in order (main set, named sets, encores) with each song's position, song id, cover / original artist, guest artists ('with'), tape flag and note, albums the songs come from, attendance count, edit activity (count, last editor, last edit time) and last update. Upcoming shows return the concert bill instead.

ParameterAllowed / rangeDescription
setlistrequired—Setlist id (`33754819`) or any setlist.fm setlist / show link.
Try in playground →
post/setlistfm/v1/artist2 credits

An artist's page: name, setlist.fm id, MusicBrainz id, image, attendance (attendances and users), the current tour's set-time averages, upcoming shows, the filter facets with counts (tours with ids, countries, venues, years) and one page of the artist's setlists (newest first, 10 per page), filterable by tour, country, venue and year.

ParameterAllowed / rangeDescription
artistrequired—Artist: setlist.fm id (`53d6ebd5`), slug-id (`muse-53d6ebd5`), any setlist.fm artist / stats link, or the artist's name (`Muse`, resolved through the site's own search — one extra request).
touroptional—Tour id.
countryoptional—Two-letter country code.
venueoptional—Venue id.
yearoptional1900–2100Only setlists from this year.
page = 1optional1–1000Result page (10 setlists per page — the site's own page size). The site serves at most 1,000 pages (10,000 rows) of any one list; narrow the filters to reach older rows.
Try in playground →
post/setlistfm/v1/artist_stats2 credits

An artist's statistics, as the site's stats tabs print them: `songs` (every song with its performance count and song id), `albums`, `covers` (artists and songs the artist covered), `with` (guests on stage and their songs), `covered` (other artists playing this artist's songs) or `concert_map` (concerts per country). Filter by year or tour; the side lists of years and tours (with setlist counts and tour ids) come with every view.

ParameterAllowed / rangeDescription
artistrequired—Artist: setlist.fm id (`53d6ebd5`), slug-id (`muse-53d6ebd5`), any setlist.fm artist / stats link, or the artist's name (`Muse`, resolved through the site's own search — one extra request).
view = songsoptionalsongs · albums · covers · with · covered · concert_mapWhich statistics tab.
yearoptional1900–2100Only setlists from this year.
touroptional—Tour id (`tour.id` on any setlist row, or `tours[].id` from artist_stats).
Try in playground →
post/setlistfm/v1/song_stats2 credits

One song of an artist: release it comes from, total plays by the artist, plays by all artists (and how many artists), first and most recent concert (date + setlist), plays per year — plus the artist's complete song list with setlist counts and song ids. Without `song` it returns the song list only.

ParameterAllowed / rangeDescription
artistrequired—Artist: setlist.fm id (`53d6ebd5`), slug-id (`muse-53d6ebd5`), any setlist.fm artist / stats link, or the artist's name (`Muse`, resolved through the site's own search — one extra request).
songoptional—Song id (`song_id` on a setlist song or in `artist_songs`).
Try in playground →
post/setlistfm/v1/average_setlist2 credits

The site's 'average setlist' of an artist for one year or one tour: the typical running order, with encores, covers and tape songs marked like a real setlist.

ParameterAllowed / rangeDescription
artistrequired—Artist: setlist.fm id (`53d6ebd5`), slug-id (`muse-53d6ebd5`), any setlist.fm artist / stats link, or the artist's name (`Muse`, resolved through the site's own search — one extra request).
yearoptional1900–2100Only setlists from this year.
touroptional—Tour id (`tour.id` on any setlist row, or `tours[].id` from artist_stats).
Try in playground →
post/setlistfm/v1/search_artists1 credit

Find artists by name with setlist.fm's own search: every artist whose setlists match the text, with setlist.fm id and the number of matching setlists (the search page's artist list), plus the artist the site itself proposes for the text. Use the id with `artist`, `artist_stats` or `search`.

ParameterAllowed / rangeDescription
queryrequired—Artist name or part of it.
Try in playground →
post/setlistfm/v1/search_venues1 credit

Find venues with setlist.fm's own search: the venues whose setlists match the text (name, city), with venue id and number of matching setlists, plus the matching countries with their codes.

ParameterAllowed / rangeDescription
queryrequired—Venue or city name.
Try in playground →
post/setlistfm/v1/city1 credit

A city page: state, country, other names the city is known by, nearby cities (with ids) and one page of the setlists played in the city (10 per page, newest first).

ParameterAllowed / rangeDescription
cityrequired—City id (`venue.city_id` from `venue`, or `places_near[].id`), slug-id or setlist.fm city link.
page = 1optional1–100000Result page (10 setlists per page).
Try in playground →
post/setlistfm/v1/venue1 credit

A venue: name, city, state, country, city id, address, year opened (and closed), web links, attendance, the replacement venue when the site merged it, upcoming shows (date, artist, ticket link) and one page of its setlists (10 per page) with total.

ParameterAllowed / rangeDescription
venuerequired—Venue id (`2bd6c086`), slug-id or setlist.fm venue link.
page = 1optional1–1000Result page (10 setlists per page — the site's own page size). The site serves at most 1,000 pages (10,000 rows) of any one list; narrow the filters to reach older rows.
Try in playground →
post/setlistfm/v1/festival1 credit

A festival series (e.g. Glastonbury): how many editions, how many artists have setlists, attendance, and every edition with year, name, edition id, venues and start / end day (20 editions per page).

ParameterAllowed / rangeDescription
festivalrequired—Festival series id (`3d6bd17` = Glastonbury), slug-id or link.
page = 1optional1–1000Result page (10 setlists per page — the site's own page size). The site serves at most 1,000 pages (10,000 rows) of any one list; narrow the filters to reach older rows.
Try in playground →
post/setlistfm/v1/festival_edition3 credits

One festival edition (e.g. Glastonbury 2025): dates, how many setlists and stages, attendance and the full lineup — every setlist with artist, stage, main venue, date, scheduled start and attendance (all rows in one call; 661 for Glastonbury 2025).

ParameterAllowed / rangeDescription
editionrequired—Edition id (`editions[].id` from `festival`) or its setlist.fm link.
Try in playground →
post/setlistfm/v1/user1 credit

A setlist.fm user's public profile: role badge, concerts attended and distinct artists seen, member since, last seen, edit counts and the comments on the profile. The attended concerts themselves: `search` with `attendee`.

ParameterAllowed / rangeDescription
usernamerequired—setlist.fm username (as in setlist.fm/user/<name>).
Try in playground →
post/setlistfm/v1/top1 credit

setlist.fm's own charts: for artists / venues / festivals — top by concertgoers (attendance count), popular now, and by number of setlists; for setlists — top by concertgoers and popular now; `statistics` — most covered artists and most concerts in the last 365 days.

ParameterAllowed / rangeDescription
kind = artistsoptionalartists · venues · setlists · festivals · statisticsWhich chart page.
Try in playground →
post/setlistfm/v1/browse1 credit

The site's alphabetical directory of artists, venues or festivals: 60 names per page under one letter (plus that letter's top 10 by concertgoers), with the page's name range and the number of pages for the letter.

ParameterAllowed / rangeDescription
kind = artistsoptionalartists · venues · festivalsWhich directory.
letterrequired—A–Z, or `0-9` for names starting with a digit or symbol.
page = 1optional1–5000Page within the letter (60 names each).
Try in playground →
post/setlistfm/v1/autocomplete1 credit

The suggestions setlist.fm's search box shows while typing (artist, venue, city, tour names and ready-made search queries).

ParameterAllowed / rangeDescription
queryrequired—At least 2 characters.
Try in playground →
Built for volume
5M+ requests a day

Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.

Missing a source?
We build it

Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.

Support
2 minute median reply

Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.

One key, one balance
Every API included

No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.

Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.