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.
/setlistfm/v1/search1 creditSearch setlist.fm's setlists with the site's own search: free text plus every filter its search page and advanced search offer — artist, venue, tour, country (code or name), city, song (id or title), year, one date or a date range, attendee, editor, set name, song note and upcoming shows. 10 rows per page (the site's page size), `total` = the site's own facet sum (equals pages × 10 within one page), plus the result's facets (artists, countries, venues, years with counts and ids to filter by). The site stops at page 1,000.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | optional | — | Free text, exactly as typed into setlist.fm's search box (matches artist, venue, city, tour and song names). The site's own operators work inside it too: `artist:(muse)`, `song:(hysteria)`, `city:(manchester)`, `date:2026-11-13`, `date:[2024-01-01 TO 2024-12-31]`. |
| artist | optional | — | Artist filter: id, slug-id or setlist.fm link (exact artist; the facet `artists` lists the ids of every artist in the current result). |
| artist_name | optional | — | Artist name as text (`artist:(…)` operator — a word match, so `Muse` also returns `Muse France Tribute`; use `artist` with the id for the exact artist). |
| venue | optional | — | Venue id (`venue.id` on a row, or the `venues` facet). |
| venue_name | optional | — | Venue name as text (`venue:(…)` operator). |
| city | optional | — | City name (`city:(…)` operator). |
| country | optional | — | Country: two-letter code (`gb`, `us`, `de` — the site's own country filter, exact) or a country name (`Germany`, `country:(…)` operator). |
| tour | optional | — | Tour id (`tour.id` on a row). |
| tour_name | optional | — | Tour name as text (`tour:(…)` operator). |
| song | optional | — | Song id (`song_id` from a setlist or song_stats): setlists that contain that song. |
| song_name | optional | — | Song title as text (`song:(…)` operator). |
| year | optional | 1900–2100 | Only setlists from this year (the site's year filter). |
| date | optional | — | One day, YYYY-MM-DD. |
| date_from | optional | — | Range start, YYYY-MM-DD (with or without date_to). |
| date_to | optional | — | Range end, YYYY-MM-DD. |
| attendee | optional | — | Concerts a setlist.fm user marked as attended (`attendee:` operator) — the user's public concert list. |
| editor | optional | — | Setlists edited by this setlist.fm user (`editor:` operator). |
| edited_from | optional | — | Only setlists edited on or after this day, YYYY-MM-DD (`edited:[… TO …]` operator). |
| edited_to | optional | — | Only setlists edited on or before this day, YYYY-MM-DD. |
| set_name | optional | — | Setlists with a set of this name (`set:(…)` operator). |
| info | optional | — | Text in a song note (`info:(…)` operator). |
| upcoming = false | optional | — | Also include shows further in the future (the site's 'Include upcoming shows' box). |
| page = 1 | optional | 1–1000 | Result 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. |
/setlistfm/v1/setlist1 creditOne 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.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| setlist | required | — | Setlist id (`33754819`) or any setlist.fm setlist / show link. |
/setlistfm/v1/artist2 creditsAn 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.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| artist | required | — | 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). |
| tour | optional | — | Tour id. |
| country | optional | — | Two-letter country code. |
| venue | optional | — | Venue id. |
| year | optional | 1900–2100 | Only setlists from this year. |
| page = 1 | optional | 1–1000 | Result 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. |
/setlistfm/v1/artist_stats2 creditsAn 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.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| artist | required | — | 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 = songs | optional | songs · albums · covers · with · covered · concert_map | Which statistics tab. |
| year | optional | 1900–2100 | Only setlists from this year. |
| tour | optional | — | Tour id (`tour.id` on any setlist row, or `tours[].id` from artist_stats). |
/setlistfm/v1/song_stats2 creditsOne 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.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| artist | required | — | 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). |
| song | optional | — | Song id (`song_id` on a setlist song or in `artist_songs`). |
/setlistfm/v1/average_setlist2 creditsThe 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.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| artist | required | — | 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). |
| year | optional | 1900–2100 | Only setlists from this year. |
| tour | optional | — | Tour id (`tour.id` on any setlist row, or `tours[].id` from artist_stats). |
/setlistfm/v1/search_artists1 creditFind 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`.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Artist name or part of it. |
/setlistfm/v1/search_venues1 creditFind 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.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | Venue or city name. |
/setlistfm/v1/city1 creditA 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).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| city | required | — | City id (`venue.city_id` from `venue`, or `places_near[].id`), slug-id or setlist.fm city link. |
| page = 1 | optional | 1–100000 | Result page (10 setlists per page). |
/setlistfm/v1/venue1 creditA 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.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| venue | required | — | Venue id (`2bd6c086`), slug-id or setlist.fm venue link. |
| page = 1 | optional | 1–1000 | Result 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. |
/setlistfm/v1/festival1 creditA 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).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| festival | required | — | Festival series id (`3d6bd17` = Glastonbury), slug-id or link. |
| page = 1 | optional | 1–1000 | Result 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. |
/setlistfm/v1/festival_edition3 creditsOne 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).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| edition | required | — | Edition id (`editions[].id` from `festival`) or its setlist.fm link. |
/setlistfm/v1/user1 creditA 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`.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| username | required | — | setlist.fm username (as in setlist.fm/user/<name>). |
/setlistfm/v1/top1 creditsetlist.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.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| kind = artists | optional | artists · venues · setlists · festivals · statistics | Which chart page. |
/setlistfm/v1/browse1 creditThe 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.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| kind = artists | optional | artists · venues · festivals | Which directory. |
| letter | required | — | A–Z, or `0-9` for names starting with a digit or symbol. |
| page = 1 | optional | 1–5000 | Page within the letter (60 names each). |
/setlistfm/v1/autocomplete1 creditThe suggestions setlist.fm's search box shows while typing (artist, venue, city, tour names and ready-made search queries).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | required | — | At least 2 characters. |
curl -X POST https://api.reefapi.com/setlistfm/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"coldplay"}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}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.
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.
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.
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.