Bandsintown V2 API

Responses

Artist - JSON

{
  "name": "Damian Marley",
  "image_url": "http://www.bandsintown.com/DamianMarley/photo/medium.jpg",
  "thumb_url": "http://www.bandsintown.com/DamianMarley/photo/small.jpg",
  "facebook_tour_dates_url": "http://bnds.in/jrHVeT",
  "mbid": "cbfb9bcd-c5a0-4d7c-865f-2c641c171e1c",
  "upcoming_events_count": 7
}

Field Details:

Artist object
Name Description Data Type
name artist name String
image_url artist image url String
thumb_url artist thumbnail image url String
facebook_tour_dates_url shortened url to the artist's tour dates page on facebook String or null
mbid music brainz id or null if not available String or null
upcoming_events_count number of upcoming events Number

Requests

Artist - XML

<artist>
  <name>Damian Marley</name>
  <image_url>http://www.bandsintown.com/DamianMarley/photo/medium.jpg</image_url>
  <thumb_url>http://www.bandsintown.com/DamianMarley/photo/small.jpg</thumb_url>
  <facebook_tour_dates_url>http://bnds.in/jrHVeT</facebook_tour_dates_url>
  <mbid>cbfb9bcd-c5a0-4d7c-865f-2c641c171e1c</mbid>
  <upcoming_events_count>7</upcoming_events_count>
</artist>

Field Details:

artist element
Name Description Data Type
name artist name string
image_url artist image url string
thumb_url artist thumbnail image url string
facebook_tour_dates_url shortened url to the artist's tour dates page on facebook string or null
mbid music brainz id or empty if unavailable string or empty
upcoming_events_count number of upcoming events int

Requests

Event - JSON

{
  "id": 4189861,
  "title": "Nas @ UB Stadium in Buffalo, NY",
  "datetime": "2011-04-29T19:00:00",
  "formatted_datetime": "Friday, April 29, 2011 at 7:00pm",
  "formatted_location": "Buffalo, NY",
  "ticket_url": "http://www.bandsintown.com/event/4189861/buy_tickets?artist=Nas",
  "ticket_type": "Tickets",
  "ticket_status": "available",
  "on_sale_datetime": "2011-03-08T10:00:00",
  "facebook_rsvp_url": "http://www.bandsintown.com/event/4189861?artist=Nas",
  "description": "2011 Block Party: featuring Kid Cudi, Damian Marley, Nas & Spec. Guest",
  "artists": [{
    "name": "Nas",
    "mbid": "cfbc0924-0035-4d6c-8197-f024653af823",
    "image_url": "http://www.bandsintown.com/Nas/photo/medium.jpg",
    "thumb_url": "http://www.bandsintown.com/Nas/photo/small.jpg",
    "facebook_tour_dates_url": "http://bnds.in/e5CP5L"
  }],
  "venue": {
    "name": "UB Stadium", 
    "city": "Buffalo", 
    "region": "NY", 
    "country": "United States",
    "latitude": 43.0004710,
    "longitude" : -78.7802170
  }
}

Field Details:

Event object (base object)
Name Description Data Type
id bandsintown.com event id Number
title event title String
datetime datetime of the event expressed in ISO 8601 format with no timezone.
YYYY-MM-DDThh:mm:ss
String
formatted_datetime readable datetime string for display purposes String
formatted_location readable location string for display purposes
City, State (within US)
City, Country (outside US)
String
ticket_url direct link to the ticket seller String or null
ticket_type type of tickets available (presale, tickets, etc), only set when tickets are available. String or null
ticket_status tickets available/unavailable for the event String
on_sale_datetime on sale datetime for event tickets expressed in ISO 8601 format with no timezone, or null if unknown String or null
facebook_rsvp_url link to RSVP to the event String
description additional details for the event String or null
artists array of artists performing at the event Array of artist Objects
venue venue object Object
Artist object
Name Description Data Type
name artist name String
mbid music brainz id or null if not available String or null
image_url artist image url String
thumb_url artist thumbnail image url String
facebook_tour_dates_url shortened url to the artist's tour dates page on facebook String or null
Venue object
Name Description Data Type
name venue name String
city venue city name String
region venue region name String
country venue country name String
latitude venue latitude Number
longitude venue longitude Number

Event - XML

<event>
  <id>4189861</id>
  <title>Nas @ UB Stadium in Buffalo, NY</title>
  <datetime>2011-04-29T19:00:00</datetime>
  <formatted_datetime>Friday, April 29, 2011 at 7:00pm</formatted_datetime>
  <formatted_location>Buffalo, NY</formatted_location>
  <ticket_url>http://www.bandsintown.com/event/4189861/buy_tickets?artist=Nas</ticket_url>
  <ticket_type>Tickets</ticket_type>
  <ticket_status>available</ticket_status>
  <on_sale_datetime>2011-03-08T10:00:00</on_sale_datetime>
  <facebook_rsvp_url>http://www.bandsintown.com/event/4189861?artist=Nas</facebook_rsvp_url>
  <description>2011 Block Party: featuring Kid Cudi, Damian Marley, Nas &amp; Spec. Guest</description>
  <artists>
    <artist>
      <name>Nas</name>
      <mbid>cfbc0924-0035-4d6c-8197-f024653af823</mbid>
      <image_url>http://www.bandsintown.com/Nas/photo/medium.jpg</image_url>
      <thumb_url>http://www.bandsintown.com/Nas/photo/small.jpg</thumb_url>
      <facebook_tour_dates_url>http://bnds.in/e5CP5L</facebook_tour_dates_url>
    </artist>
  </artists>
  <venue>
    <name>UB Stadium</name>
    <city>Buffalo</city>
    <region>NY</region>
    <country>United States</country>
    <latitude>43.0004710</latitude>
    <longitude>-78.7802170</longitude>
  </venue>
</event>

Field Details:

event element
Name Description Data Type
id bandsintown.com event id int
datetime datetime of the event expressed in ISO 8601 format with no timezone.
YYYY-MM-DDThh:mm:ss
dateTime
formatted_datetime readable datetime string for display purposes string
formatted_location readable location string for display purposes
City, State (within US)
City, Country (outside US)
string
ticket_url direct link to the ticket seller string or empty
ticket_type type of tickets available (presale, tickets, etc), only set when tickets are available. string or empty
ticket_status tickets available/unavailable for the event string
on_sale_datetime on sale datetime for event tickets expressed in ISO 8601 format with no timezone, or empty if unknown. dateTime or empty
facebook_rsvp_url link to RSVP to the event string
description additional details for the event string or empty
artists container element of artists performing at this event n/a
venue venue container element n/a
artist element
Name Description Data Type
name artist name string
mbid music brainz id or empty if unavailable string or empty
image_url artist image url string
thumb_url artist thumbnail image url string
facebook_tour_dates_url shortened url to the artist's tour dates page on facebook string or null
venue element
Name Description Data Type
name venue name string
city venue city name string
region venue region name string
country venue country name string
latitude venue latitude float
latitude venue latitude float

Events - JSON

[{
  "id": 4189861,
  "title": "Nas @ UB Stadium in Buffalo, NY",
  "datetime": "2011-04-29T19:00:00",
  "formatted_datetime": "Friday, April 29, 2011 at 7:00pm",
  "formatted_location": "Buffalo, NY",
  "ticket_url": "http://www.bandsintown.com/event/4189861/buy_tickets?artist=Nas",
  "ticket_type": "Tickets",
  "ticket_status": "available",
  "on_sale_datetime": "2011-03-08T10:00:00",
  "facebook_rsvp_url": "http://www.bandsintown.com/event/4189861?artist=Nas",
  "description": "2011 Block Party: featuring Kid Cudi, Damian Marley, Nas & Spec. Guest",
  "artists": [{
    "name": "Nas",
    "mbid": "cfbc0924-0035-4d6c-8197-f024653af823",
    "image_url": "http://www.bandsintown.com/Nas/photo/medium.jpg",
    "thumb_url": "http://www.bandsintown.com/Nas/photo/small.jpg",
    "facebook_tour_dates_url": "http://bnds.in/e5CP5L"
  }],
  "venue": {
    "name": "UB Stadium", 
    "city": "Buffalo", 
    "region": "NY", 
    "country": "United States",
    "latitude": 43.0004710,
    "longitude" : -78.7802170
  }
}]

Field Details:

The response is an array of Event objects. See Event - JSON for field details.

Requests

Events - XML

<events>
  <event>
    <id>4189861</id>
    <title>Nas @ UB Stadium in Buffalo, NY</title>
    <datetime>2011-04-29T19:00:00</datetime>
    <formatted_datetime>Friday, April 29, 2011 at 7:00pm</formatted_datetime>
    <formatted_location>Buffalo, NY</formatted_location>
    <ticket_url>http://www.bandsintown.com/event/4189861/buy_tickets?artist=Nas</ticket_url>
    <ticket_type>Tickets</ticket_type>
    <ticket_status>available</ticket_status>
    <on_sale_datetime>2011-03-08T10:00:00</on_sale_datetime>
    <facebook_rsvp_url>http://www.bandsintown.com/event/4189861?artist=Nas</facebook_rsvp_url>
    <description>2011 Block Party: featuring Kid Cudi, Damian Marley, Nas &amp; Spec. Guest</description>
    <artists>
      <artist>
        <name>Nas</name>
        <mbid>cfbc0924-0035-4d6c-8197-f024653af823</mbid>
        <image_url>http://www.bandsintown.com/Nas/photo/medium.jpg</image_url>
        <thumb_url>http://www.bandsintown.com/Nas/photo/small.jpg</thumb_url>
        <facebook_tour_dates_url>http://bnds.in/e5CP5L</facebook_tour_dates_url>
      </artist>
    </artists>
    <venue>
      <name>UB Stadium</name>
      <city>Buffalo</city>
      <region>NY</region>
      <country>United States</country>
      <latitude>43.0004710</latitude>
      <longitude>-78.7802170</longitude>
    </venue>
  </event>
</events>

Field Details:

The response is a list of event elements. See Event - XML for field details.

Requests

Errors - JSON

 {
   errors: [
     "Artist is a required field",
     "Location not found"
   ]
 }

Errors - XML

<error_response>
  <errors>
    <error>Artist is a required field</error>
    <error>Location not found</error>
  </errors>
</error_response>