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"
Examples
Lookup Skrillex:
http://api.bandsintown.com/artists/Skrillex.json?api_version=2.0&app_id=YOUR_APP_ID
Lookup Metallica using music brainz id (artist name unknown):
http://api.bandsintown.com/artists/mbid_65f4f0c5-ef9e-490c-aee3-909e7ae6b2ab?format=xml&api_version=2.0&app_id=YOUR_APP_ID
Lookup Crystal Castles (using JSONP callback):
http://api.bandsintown.com/artists/Crystal%20Castles.json?app_id=YOUR_APP_ID&api_version=2.0&callback=showArtist
Lookup Lil Wayne using facebook page id:
http://api.bandsintown.com/artists/Lil%20Wayne?format=json&artist_id=fbid_6885814958&api_version=2.0&app_id=YOUR_APP_ID
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"
Examples
All upcoming Skrillex shows:
http://api.bandsintown.com/artists/Skrillex/events.json?api_version=2.0&app_id=YOUR_APP_ID
All upcoming Lil Wayne shows using facebook page id:
http://api.bandsintown.com/artists/Lil%20Wayne/events.json?artist_id=fbid_6885814958&api_version=2.0&app_id=YOUR_APP_ID
All upcoming Metallica shows using music brainz id (artist name unknown):
http://api.bandsintown.com/artists/mbid_65f4f0c5-ef9e-490c-aee3-909e7ae6b2ab/events?format=xml&api_version=2.0&app_id=YOUR_APP_ID
All upcoming Miike Snow shows (using JSONP callback):
http://api.bandsintown.com/artists/Miike%20Snow/events.json?api_version=2.0&app_id=YOUR_APP_ID&callback=showEvents
All upcoming and past Nas shows:
http://api.bandsintown.com/artists/Nas/events?format=json&app_id=YOUR_APP_ID&date=all
Artists - Event Search
Description
Returns events for a single artist matching search criteria (see below for available params). Useful in searching for an artist's local events or an artist's local events within a specific time frame. If you are looking for all upcoming events for a single artist use Artists - Events.
URL
http://api.bandsintown.com/artists/name/events/search.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. |
| location | - |
city,state (US or CA) city,country lat,lon ip address use_geoip (will use the ip the request came from) |
yes | - |
| radius | 25 | number (miles) | no | max 150 |
| 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"
Examples
Upcoming Skrillex events within 10 miles of San Diego, CA:
http://api.bandsintown.com/artists/Skrillex/events/search.json?api_version=2.0&app_id=YOUR_APP_ID&location=San+Diego,CA&radius=10
Upcoming Metallica events using music brainz id (artist name unknown) near your location:
http://api.bandsintown.com/artists/mbid_65f4f0c5-ef9e-490c-aee3-909e7ae6b2ab/events/search.xml?format=xml&api_version=2.0&app_id=YOUR_APP_ID&location=use_geoip
Upcoming Nas shows near London, United Kingdom (using JSONP callback):
http://api.bandsintown.com/artists/Nas/events/search?format=json&app_id=YOUR_APP_ID&api_version=2.0&location=London,United+Kingdom&callback=showArtist
Upcoming Lil Wayne concerts (using facebook page id) in New York, NY during January 2014:
http://api.bandsintown.com/artists/Lil%20Wayne/events/search?format=json&artist_id=fbid_6885814958&api_version=2.0&app_id=YOUR_APP_ID&date=2014-01-01,2014-01-31&location=New+York,NY
Artists - Recommended Events
Description
Returns recommended events for a single artist matching search criteria (see below for available params).
URL
http://api.bandsintown.com/artists/name/events/recommended.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. |
| location | - |
city,state (US or CA) city,country lat,lon ip address use_geoip (will use the ip the request came from) |
yes | - |
| radius | 25 | number (miles) | no | max 150 |
| date | upcoming |
yyyy-mm-dd yyyy-mm-dd,yyyy-mm-dd (inclusive range) upcoming all |
no | - |
| only_recs | false | true/false | no | if true, the response will only include matching events for artists similar to the specified artist. if false, the response may also include matching events for the specified artist. |
| 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"
Examples
Recommended upcoming shows for Skrillex fans within 10 miles of Boston, MA:
http://api.bandsintown.com/artists/Skrillex/events/recommended?location=Boston,MA&radius=10&app_id=YOUR_APP_ID&api_version=2.0&format=json
Recommended upcoming shows for Crystal Castles fans (excluding Crystal Castles shows) within 50 miles of your location:
http://api.bandsintown.com/artists/Crystal%20Castles/events/recommended?location=use_geoip&radius=50&app_id=YOUR_APP_ID&api_version=2.0&format=json
Recommended upcoming shows for Metallica fans using music brainz id (artist name unknown) near San Diego, CA:
http://api.bandsintown.com/artists/mbid_65f4f0c5-ef9e-490c-aee3-909e7ae6b2ab/events/recommended?location=San+Diego,CA&format=xml&api_version=2.0&app_id=YOUR_APP_ID
Recommended upcoming shows for Nas fans near London, United Kingdom (using JSONP callback):
http://api.bandsintown.com/artists/Nas/events/recommended?format=json&app_id=YOUR_APP_ID&api_version=2.0&location=London,United+Kingdom&callback=showEvents
Recommended upcoming Lil Wayne concerts (using facebook page id) in New York, NY during January 2014:
http://api.bandsintown.com/artists/Lil%20Wayne/events/recommended?format=json&artist_id=fbid_6885814958&api_version=2.0&app_id=YOUR_APP_ID&date=2014-01-01,2014-01-31&location=New+York,NY
© 2013 Bandsintown | All Rights Reserved
