# setlist.fm API: Get concert setlist

> 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.

Unofficial. Not affiliated with or endorsed by setlist.fm.

- Page: https://fous.com/methods/setlist.fm/get-concert-setlist
- Method: `setlist.fm/get_concert_setlist`, version 1
- Website: setlist.fm
- Returns: artist, date, venue, city, country, tour, start time, setlist link, songs with encore, cover and note
- 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 |
|---|---|---|---|---|
| `city` | string | no | `"London"` | City where the concert took place, for example London. |
| `date` | string | no |  | Concert date (YYYY-MM-DD), for example 2024-06-21. |
| `artist` | string | yes | `"Taylor Swift"` | Artist or band name, for example Taylor Swift. |

## Output

From a run on Oct 31, 2026, shortened. Its input:

```json
{
  "city": "London",
  "artist": "Taylor Swift"
}
```

Its output:

```json
{
  "city": "London",
  "date": "2024-08-20",
  "songs": [
    {
      "note": "shortened",
      "title": "Miss Americana & the Heartbreak Prince",
      "encore": false,
      "position": 1,
      "original_artist": null
    },
    {
      "note": "extended outro",
      "title": "Cruel Summer",
      "encore": false,
      "position": 2,
      "original_artist": null
    },
    {
      "note": "spoken intro",
      "title": "The Man",
      "encore": false,
      "position": 3,
      "original_artist": null
    }
  ],
  "venue": "Wembley Stadium",
  "artist": "Taylor Swift",
  "country": "England",
  "tour_name": "The Eras Tour",
  "setlist_id": "23aa40cf",
  "setlist_link": "https://www.setlist.fm/setlist/taylor-swift/2024/wembley-stadium-london-england-23aa40cf.html",
  "show_start_time": "18:55"
}
```

## 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_concert_setlist","input":{"city":"London","artist":"Taylor Swift"}}'
```

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

- What songs did Radiohead play at their show in Mexico City on 2025-11-04?
- Pull up the setlist.fm setlist for Taylor Swift's London concert on 2024-06-21, including encore songs and any covers.
- I'm going to see Pearl Jam — what was the song list at their most recent show in Chicago?
- Find the setlist from Billie Eilish's concert on 2024-09-29 at Quebec City, with venue, tour name and start time.
- Check setlist.fm for the latest Metallica concert in Gothenburg and tell me which songs they did in the encore.

## Input schema

```json
{
  "type": "object",
  "required": [
    "artist"
  ],
  "properties": {
    "city": {
      "type": "string",
      "description": "City where the concert took place, for example London."
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "Concert date (YYYY-MM-DD), for example 2024-06-21."
    },
    "artist": {
      "type": "string",
      "description": "Artist or band name, for example Taylor Swift."
    }
  },
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "artist",
    "date",
    "venue",
    "city",
    "country",
    "tour_name",
    "show_start_time",
    "setlist_link",
    "setlist_id",
    "songs"
  ],
  "properties": {
    "city": {
      "type": "string"
    },
    "date": {
      "type": "string",
      "format": "date"
    },
    "songs": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "position",
          "title",
          "encore",
          "original_artist",
          "note"
        ],
        "properties": {
          "note": {
            "type": [
              "string",
              "null"
            ],
            "description": "Note shown beside this song, if given."
          },
          "title": {
            "type": "string",
            "description": "Song title."
          },
          "encore": {
            "type": "boolean",
            "description": "Whether this song appears in the encore."
          },
          "position": {
            "type": "integer",
            "description": "Song order in the listed setlist."
          },
          "original_artist": {
            "type": [
              "string",
              "null"
            ],
            "description": "Original artist for a cover, if given."
          }
        },
        "additionalProperties": false
      }
    },
    "venue": {
      "type": "string"
    },
    "artist": {
      "type": "string"
    },
    "country": {
      "type": "string"
    },
    "tour_name": {
      "type": [
        "string",
        "null"
      ]
    },
    "setlist_id": {
      "type": "string",
      "x-fous-developer": true
    },
    "setlist_link": {
      "type": "string"
    },
    "show_start_time": {
      "type": [
        "string",
        "null"
      ],
      "description": "Local start time in 24-hour HH:MM format, where listed; timezone unavailable."
    }
  },
  "additionalProperties": false
}
```

## See more

- [setlist.fm API: Get tour song statistics](https://fous.com/methods/setlist.fm/get-tour-song-stats.md): 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.
- [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.
- [Songkick API: Search concerts in a city](https://fous.com/methods/songkick.com/search-concerts.md): Finds upcoming concerts in a city between two dates on Songkick. Each concert includes its artists, venue, festival name and ticket link.
- [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.
- [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.
- [MusicBrainz API: Get artist by name](https://fous.com/methods/musicbrainz.org/get-artist.md): Looks up an artist or band on MusicBrainz by name, optionally narrowed by country, and returns reference details, recorded members, aliases, genres and official links.
- [Eventbrite API: Search events](https://fous.com/methods/eventbrite.com/search-events.md): Finds public Eventbrite events in a city or online, with optional keywords, date range, category and free-only filtering, ordered by start time.
- [Last.fm API: List similar artists](https://fous.com/methods/last.fm/list-similar-artists.md): Finds artists similar to a named artist on Last.fm, ordered by similarity. Similarity percentages are null because public pages do not show them.
- [All setlist.fm methods](https://fous.com/methods/setlist.fm.md)