Developer API
Requests
Artists - Events
Parameters
| name | default | format | required | notes |
|---|---|---|---|---|
| artist | - |
artist name (url escaped*) mbid_<id> (MusicBrainz ID) |
yes | - |
| format | - | xml or json | yes | - |
| app_id | - | word | yes | a word to identify your application or company |
* note: / and ? characters must be double escaped. Artists such as "AC/DC" will end up as "AC%252FDC"
Examples
All upcoming Little Brother shows:
http://api.bandsintown.com/artists/Little%20Brother/events.json?app_id=YOUR_APP_ID
All upcoming Metallica shows using music brainz id:
http://api.bandsintown.com/artists/mbid_65f4f0c5-ef9e-490c-aee3-909e7ae6b2ab/events?format=xml&app_id=YOUR_APP_ID
Events - Search
Parameters
| Name | Default | Format | Required | Notes |
|---|---|---|---|---|
| artists[] | - |
artist name mbid_<id> (MusicBrainz ID) |
artists or location must be present |
no more than 50 artists per request |
| location | - |
city,state (US or CA) city,country lat,lon ip address use_geoip (will use the ip the request came from) |
artists or location must be present |
- |
| radius | 25 | number (miles) | no | max 150 |
| date | upcoming |
yyyy-mm-dd yyyy-mm-dd,yyyy-mm-dd (inclusive range) upcoming |
no | - |
| page | 1 | number | no | - |
| per_page | 50 | number | no | max 100 |
| format | - | xml or json | yes | - |
| app_id | - | word | yes | a word to identify your application or company |
Examples
All upcoming Little Brother shows within 10 miles of Boston, MA:
http://api.bandsintown.com/events/search?artists[]=Little+Brother&location=Boston,MA&radius=10&format=json&app_id=YOUR_APP_ID
All upcoming Common or Dwele shows:
http://api.bandsintown.com/events/search?artists[]=Common&artists[]=Dwele&format=xml&app_id=YOUR_APP_ID
Events - Recommended
Parameters
| name | default | format | required | notes |
|---|---|---|---|---|
| artists[] | - |
artist name mbid_<id> (MusicBrainz ID) |
yes | no more than 50 artists per request |
| 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 |
no | - |
| only_recs | false | true/false | no | - |
| page | 1 | number | no | - |
| per_page | 50 | number | no | max 100 |
| format | - | xml or json | yes | - |
| app_id | - | word | yes | a word to identify your application or company |
Examples
All recommended upcoming shows for Little Brother fans within 10 miles of Boston, MA:
http://api.bandsintown.com/events/recommended?artists[]=Little+Brother&location=Boston,MA&radius=10&format=json&app_id=YOUR_APP_ID
All recommended upcoming shows for Little Brother fans (excluding Little Brother shows) within 10 miles of Boston, MA:
http://api.bandsintown.com/events/recommended?artists[]=Little+Brother&location=Boston,MA&radius=10&only_recs=true&format=json&app_id=YOUR_APP_ID
All recommended upcoming shows for Common or Dwele fans within 25 miles of Chicago, IL:
http://api.bandsintown.com/events/recommended?artists[]=Common&artists[]=Dwele&location=Chicago,IL&format=xml&app_id=YOUR_APP_ID
Events - Daily
Parameters
| name | default | format | required | notes |
|---|---|---|---|---|
| format | - | xml or json | yes | - |
| app_id | - | word | yes | a word to identify your application or company |
Examples
All upcoming shows added in the last day (json)
http://api.bandsintown.com/events/daily?format=json&app_id=YOUR_APP_ID
All upcoming shows added in the last day (xml) - using alternate format syntax
http://api.bandsintown.com/events/daily.xml?app_id=YOUR_APP_ID
© 2009 Bandsintown | All Rights Reserved
