Bandsintown V2 API

Requests

Artists - Get

Description

Returns basic information for a single artist, including the number of upcoming events. Useful in determining if an artist is on tour without requesting the event data.

URL

http://api.bandsintown.com/artists/name.format

Request Method

GET

Parameters

name default format required notes
artist - artist name (url escaped*),
mbid_<id>
(MusicBrainz ID),
fbid_<id>
(Facebook Page ID)
yes artist id formats should only be used in this parameter when the artist name is unknown, otherwise use the artist_id param described below
artist_id - artist id
mbid_<id>
(MusicBrainz ID),
fbid_<id>
(Facebook Page ID)
no the artist id will take precedence over the artist name if found, will fall back to the artist name otherwise.
callback - function name no if passed, the response will be wrapped in a function call to the given callback name - JSON requests only (JSONP)
format - xml or json yes -
app_id - word yes a word to identify your application or company
api_version 1.0 1.0 or 2.0 yes This parameter is required to use the 2.0 API

Note: / and ? characters must be double escaped. Artists such as "AC/DC" will end up as "AC%252FDC"

Response

Artists - Events

Description

Returns events for a single artist (default upcoming).

URL

http://api.bandsintown.com/artists/name/events.format

Request Method

GET

Parameters

name default format required notes
artist - artist name (url escaped*),
mbid_<id>
(MusicBrainz ID),
fbid_<id>
(Facebook Page ID)
yes artist id formats should only be used in this parameter when the artist name is unknown, otherwise use the artist_id param described below
artist_id - artist id
mbid_<id>
(MusicBrainz ID),
fbid_<id>
(Facebook Page ID)
no the artist id will take precedence over the artist name if found, will fall back to the artist name otherwise.
date upcoming yyyy-mm-dd
yyyy-mm-dd,yyyy-mm-dd (inclusive range)
upcoming
all
no -
callback - function name no if passed, the response will be wrapped in a function call to the given callback name - JSON requests only (JSONP)
format - xml or json yes -
app_id - word yes a word to identify your application or company
api_version 1.0 1.0 or 2.0 yes This parameter is required to use the 2.0 API

Note: / and ? characters must be double escaped. Artists such as "AC/DC" will end up as "AC%252FDC"

Response