Setlist

setlist.fm API

The setlist.fm API has been designed to give you easy access to setlist data in order to build fancy websites and other applications. Before starting to use…

Media & content#openapi#media

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

The setlist.fm API has been designed to give you easy access to setlist data in order to build fancy websites and
other applications. Before starting to use the API, be sure to ...

... understand how setlist.fm works (the FAQ and the
Guidelines are a good starting point),
... read this documentation carefully and
... apply for an API key (link for logged in users only) - if
you're no registered user yet, then register first (it's free).

If this documentation isn't enough or if you've got other things you'd like to tell us about the API, visit the
API Forum .

Note that the setlist.fm API is, according to the API terms of
service , only free for non-commercial projects. If you're interested in using the API for commercial purposes,
contact us .

About this Service

This service provides methods to get both setlists and components of setlists such as artists, cities, countries or
venues.

Supported Content Types

The REST service currently supports XML (default) and JSON content.

To receive a JSON response, set the Accept
header to application/json .

Internationalization

(Please note that this is an experimental feature and does not work for all cities!)

Most of the featured methods honor the Accept-Language
header . This header is used for
localizing cities and countries. The default language is English (en), but you can provide any of the languages
Spanish (es), French (fr), German (de), Portuguese (pt), Turkish (tr), Italian (it) or Polish (pl).

E.g. if you search a setlist for a concert that took place in Vienna and you pass "de" as header, you'll
get "Wien, Österreich" instead of "Vienna, Austria" .
This also works if you use a different language than the country's native language.

E.g. for a concert in New York, you'll get "Nueva York, Estados Unidos" instead of "New
York, United States" if you pass "es" as language.

API Keys

API keys ( application form ) must be included in the request with
the x-api-key header.

Version History

Version
Docs
End of Service

1.0
Docs
-

0.1

December 31, 2017

Endpoints 15

/1.0/artist/{mbid}

  • GET./1.0/artist/:mbid<p> Returns an artist for a given Musicbrainz MBID </p>

/1.0/artist/{mbid}/setlists

  • GET./1.0/artist/:mbid/setlists?p=1<p> Get a list of an artist's setlists. </p>

/1.0/city/{geoId}

  • GETGet a city by its unique geoId./1.0/city/:geoIdGet a city by its unique geoId.

/1.0/search/artists

  • GETSearch for artists./1.0/search/artists?artistMbid=string&artistName=string&artistTmid=0&p=1&sort=sortNameSearch for artists.

/1.0/search/cities

  • GETSearch for a city./1.0/search/cities?country=string&name=string&p=1&state=string&stateCode=stringSearch for a city.

/1.0/search/countries

  • GETGet a complete list of all supported countries./1.0/search/countriesGet a complete list of all supported countries.

/1.0/search/setlists

  • GETSearch for setlists./1.0/search/setlists?artistMbid=string&artistName=string&artistTmid=0&cityId=string&cityName=string&countryCode=string&date=string&lastFm=0&lastUpdated=string&p=1&state=string&stateCode=string&tourName=string&venueId=string&venueName=string&year=stringSearch for setlists.

/1.0/search/venues

  • GETSearch for venues./1.0/search/venues?cityId=string&cityName=string&country=string&name=string&p=1&state=string&stateCode=stringSearch for venues.

/1.0/setlist/version/{versionId}

  • GET./1.0/setlist/version/:versionId<p> Returns a setlist for the given versionId. The setlist returned isn't necessarily the most recent version. E.g. if you pass the versionId of a setlist…

/1.0/setlist/{setlistId}

  • GET./1.0/setlist/:setlistId<p> Returns the current version of a setlist. E.g. if you pass the id of a setlist that got edited since you last accessed it, you'll get the current version.…

/1.0/user/{userId}

  • GETGet a user by userId./1.0/user/:userIdGet a user by userId. (deprecated) Note: This endpoint always returns a result, even if the user doesn't exist

/1.0/user/{userId}/attended

  • GET./1.0/user/:userId/attended?p=1<p> Get a list of setlists of concerts attended by a user. </p>

/1.0/user/{userId}/edited

  • GET./1.0/user/:userId/edited?p=1<p> Get a list of setlists of concerts edited by a user. The list contains the current version, not the version edited. </p>

/1.0/venue/{venueId}

  • GETGet a venue by its unique id./1.0/venue/:venueIdGet a venue by its unique id.

/1.0/venue/{venueId}/setlists

  • GET./1.0/venue/:venueId/setlists?p=1<p> Get setlists for a specific venue. </p>

API details

Authentication
None declared in the description
Operations
15 operations on 15 pathsGET 15
Main resources
/1.0/artist/{mbid} 1/1.0/artist/{mbid}/setlists 1/1.0/city/{geoId} 1/1.0/search/artists 1/1.0/search/cities 1/1.0/search/countries 1/1.0/search/setlists 1/1.0/search/venues 1/1.0/setlist/version/{versionId} 1/1.0/setlist/{setlistId} 1
Description format
Swagger 2.0, API version 1.0
Listed from
APIs.guru OpenAPI Directory (CC0-1.0)
Source updated

How to test the setlist.fm API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the setlist.fm API collection, without the publisher's secrets.
  3. Add your credentialsOpen the collection's variables or an environment and enter your API key or token, if the API needs one.
  4. Send a requestPick an endpoint, for example “.” (GET /1.0/artist/:mbid), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the setlist.fm API?

The setlist.fm API has been designed to give you easy access to setlist data in order to build fancy websites and other applications. Before starting to use… It is listed under Media & content and has 15 endpoints.

Who publishes the setlist.fm API?

It is listed from Setlist's public API description (an OpenAPI document), not published by Setlist on Swastik Codes. Anyone who controls setlist.fm can claim the profile by adding a DNS TXT record.

How do I authenticate with the setlist.fm API?

Its OpenAPI description does not declare an authentication scheme. Some endpoints may be open; check the provider's documentation before relying on that.

How many endpoints does the setlist.fm API have?

15 operations on 15 paths (15 GET). The largest groups are /1.0/artist/{mbid}, /1.0/artist/{mbid}/setlists, /1.0/city/{geoId}, /1.0/search/artists.

Is forking the setlist.fm API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.