# setlist.fm API: Get tour song statistics > Finds the songs an artist played most on a named tour or in a year on setlist.fm, with concert counts and cover credits. Without a filter it uses the most recent tour with published song statistics. Unofficial. Not affiliated with or endorsed by setlist.fm. - Page: https://fous.com/methods/setlist.fm/get-tour-song-stats - Method: `setlist.fm/get_tour_song_stats`, version 1 - Website: setlist.fm - Returns: artist, tour or year, concerts counted, statistics link, songs with play counts, share of concerts and original artist - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `tour` | string | no | `"M72 World Tour"` | Tour name, for example M72 World Tour. Leave blank to use the most recent tour with song statistics. | | `year` | integer | no | | Concert year instead of a tour, for example 2025. | | `artist` | string | yes | `"Metallica"` | Artist or band name, for example Metallica. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "tour": "M72 World Tour", "artist": "Metallica" } ``` Its output: ```json { "tour": "M72 World Tour", "year": null, "songs": [ { "song_link": "https://www.setlist.fm/stats/songs/metallica-3bd680c8.html?songid=3b97fc90", "song_title": "Kirk and Rob Doodle", "times_played": 89, "original_artist": null, "share_of_concerts_percent": 89.9 }, { "song_link": "https://www.setlist.fm/stats/songs/metallica-3bd680c8.html?songid=5bd6fb14", "song_title": "Creeping Death", "times_played": 64, "original_artist": null, "share_of_concerts_percent": 64.6 }, { "song_link": "https://www.setlist.fm/stats/songs/metallica-3bd680c8.html?songid=bd6dd5a", "song_title": "Enter Sandman", "times_played": 64, "original_artist": null, "share_of_concerts_percent": 64.6 } ], "artist": "Metallica", "statistics_link": "https://www.setlist.fm/stats/metallica-3bd680c8.html?tour=3dff98b", "concerts_counted": 99 } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"setlist.fm/get_tour_song_stats","input":{"tour":"M72 World Tour","artist":"Metallica"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Which songs did Metallica play most often on the M72 World Tour, and how many shows were counted? - Pull the most-played songs from Taylor Swift's Eras Tour on setlist.fm, including what percentage of concerts each one appeared in - What were Pearl Jam's most frequently performed songs in 2024? Flag any covers and who originally wrote them. - I'm going to see Coldplay soon — what songs have they been playing most on their latest tour? - Check setlist.fm for Bruce Springsteen's song play counts for 2023 and tell me how often each track showed up across the concerts ## Input schema ```json { "type": "object", "required": [ "artist" ], "properties": { "tour": { "type": "string", "description": "Tour name, for example M72 World Tour. Leave blank to use the most recent tour with song statistics." }, "year": { "type": "integer", "description": "Concert year instead of a tour, for example 2025." }, "artist": { "type": "string", "description": "Artist or band name, for example Metallica." } } } ``` ## Output schema ```json { "type": "object", "required": [ "artist", "tour", "year", "concerts_counted", "statistics_link", "songs" ], "properties": { "tour": { "type": [ "string", "null" ], "description": "Tour used, or null if filtered by year." }, "year": { "type": [ "integer", "null" ], "description": "Year used, or null if filtered by tour." }, "songs": { "type": "array", "items": { "type": "object", "required": [ "song_title", "times_played", "share_of_concerts_percent", "original_artist", "song_link" ], "properties": { "song_link": { "type": "string", "description": "Page showing statistics for this song." }, "song_title": { "type": "string" }, "times_played": { "type": "integer" }, "original_artist": { "type": [ "string", "null" ], "description": "Original artist for a cover, otherwise null." }, "share_of_concerts_percent": { "type": "number", "description": "Times played divided by setlists counted, capped at 100%." } }, "additionalProperties": false }, "description": "Songs in descending order by number of performances." }, "artist": { "type": "string", "description": "Artist name on setlist.fm." }, "statistics_link": { "type": "string", "description": "Tour or year statistics page." }, "concerts_counted": { "type": "integer", "description": "Setlists listed by setlist.fm for this tour or year." } }, "additionalProperties": false } ``` ## See more - [setlist.fm API: Get concert setlist](https://fous.com/methods/setlist.fm/get-concert-setlist.md): Get one artist's concert details and songs from setlist.fm by date or city. With only a city, returns the most recent matching concert there. Start times are local clock times because the pages do not supply a timezone. - [Songkick API: Get artist tour dates](https://fous.com/methods/songkick.com/get-artist-tour-dates.md): Gets an artist's upcoming concerts and tour dates on Songkick, optionally filtered by country, with ticket links and start times when listed. - [Last.fm API: Get artist](https://fous.com/methods/last.fm/get-artist.md): Looks up a Last.fm artist by name and returns listening statistics, profile, top tracks and albums, similar artists, and upcoming events. - [Billboard API: Get an artist's chart history](https://fous.com/methods/billboard.com/get-artist-chart-history.md): Returns an artist's Billboard Hot 100 song history or Billboard 200 album history: chart totals (entries, No. 1 hits, top 10 hits) and each title's debut, peak and weeks on chart, most recent debut first. - [Genius API: List an artist's songs](https://fous.com/methods/genius.com/list-artist-songs.md): Lists an artist's songs on Genius by popularity or newest release date, with featured artists, release dates, page views and song art. The artist can be given by name or by Genius artist link; dates or views may be unavailable. - [Spotify API: Get song](https://fous.com/methods/open.spotify.com/get-song.md): Finds a Spotify song by title (optionally narrowed by artist), track link, URI or track ID and returns its public play count and details. Without an artist, the most-played exact title match wins. Previews and ISRC may be unavailable for some tracks. - [PGA Tour API: Get schedule](https://fous.com/methods/pgatour.com/get-schedule.md): Returns the PGA Tour season schedule for a year, with dates, venue, purse, status, winners and defending champions. - [Ticketmaster API: Search events](https://fous.com/methods/ticketmaster.com/search-events.md): Finds upcoming Ticketmaster-listed concerts, sports, theater and other events by keyword, optionally by city, country, category and date range, with dates, venues, prices when shown and links. Partner-only listings without a Ticketmaster link are excluded; very large searches cover only the first 800 listings. - [All setlist.fm methods](https://fous.com/methods/setlist.fm.md)