API documentation
Updated over a week ago

Our API can return two different results:

  1. Artist information: returns the link to the Bandsintown artist page, the link to the artist photo, the current number of followers and more

  2. Artist events: returns the list of events including their date and time, venue name and location, ticket links, lineup, description, title, and the link to the Bandsintown event page

PLEASE NOTE: You can specify if you only want to return upcoming events, past events, all events, or events within a given date range.

For more details, look at technical documentation.

How to get artist information

By Artist Name

https://rest.bandsintown.com/artists/{{artist_name}}/?app_id=yOUrSuP3r3ven7aPp-id

By Artist ID

https://rest.bandsintown.com/artists/id_{{artist_id}}/?app_id=yOUrSuP3r3ven7aPp-id

By Facebook page ID

https://rest.bandsintown.com/artists/fbid_{{Facebook page id}}/?app_id=yOUrSuP3r3ven7aPp-id

Result

How to get event information

https://rest.bandsintown.com/artists/{{artist_name}}/events/?app_id=yOUrSuP3r3ven7aPp-id

Result

How to add calls to action

When you add these calls to action (CTA) links on your website, this will allow you to sync your live streams or concerts from your Bandsintown account straight to your website. With these CTA links, fans will always know where and when you're performing next without leaving your site, increasing event promotion, engagement and ticket sales.

Examples of CTA: Track; RSVP, Notify Me

Bandsintown URLs returned by the API

Get Event: https://rest.bandsintown.com/artists/{{artist_name}}events?app_id=yOUrSuP3r3ven7aPp-id

Event URL

"url": "https://www.bandsintown.com/e/123456?app_id=yOUrSuP3r3ven7aPp-id&came_from=267&utm_medium=api&utm_source=public_api&utm_campaign=event"

Artist URL

"url": "https://www.bandsintown.com/a/123?came_from=267&app_id=yOUrSuP3r3ven7aPp-id"

Ticket URL

"url": "https://www.bandsintown.com/t/1234?app_id=yOUrSuP3r3ven7aPp-id&came_from=267&utm_medium=api&utm_source=public_api&utm_campaign=ticket"

Live shows

"url": "https://www.bandsintown.com/l/102638?app_id=yOUrSuP3r3ven7aPp-id&came_from=267&utm_medium=api&utm_source=public_api&utm_campaign=watch_live"

If there are no tickets or live shows in an event, the "offers" array will be empty.

RSVP

Display an "RSVP button” for every show to allow fans to receive updates and reminders about the show. The link consists of the concatenation of the "url" attribute returned by the Bandsintown API for that event and the parameter &trigger=rsvp_going

https://www.bandsintown.com/e/123456?app_id=yOUrSuP3r3ven7aPp-id&came_from=267&utm_medium=api&utm_source=public_api&utm_campaign=event&trigger=rsvp_going ​ ​

Notify Me

When there is no ticket link (i.e. no "offer" in the Bandsintown API response), you could display a "Notify Me" button instead that calls the same URL as for RSVP except with the parameter &trigger=notify_me.

What that link does is allow the fan to be notified when ticket links are added to the event, so the benefit for the artist is to help increase ticket sales by creating fan anticipation as part of a pre-sale strategy. ​

https://www.bandsintown.com/e/1019985520?app_id=yOUrSuP3r3ven7aPp-id&came_from=267&utm_medium=api&utm_source=public_api&utm_campaign=event&trigger=notify_me ​

Track

Display a link to the artist page with the &trigger=track

https://www.bandsintown.com/a/163927?came_from=267&app_id=yOUrSuP3r3ven7aPp-id&trigger=track

Live Streaming Events

Please follow the recommendations in the API for Livestreams article.

Did this answer your question?