@datafire/bandsintown

Client library for Bandsintown API

Installation and Usage

npm install --save @datafire/bandsintown

let bandsintown = require('@datafire/bandsintown').create();

.then(data => {
  console.log(data);
});

Description

What is the Bandsintown API?

The Bandsintown API is designed for artists and enterprises representing artists.

It offers read-only access to artist info and artist events:

• artist info: returns the link to the Bandsintown artist page, the link to the artist photo, the current number of trackers and more
• artist events: returns the list of events including their date and time, venue name and location, ticket links, lineup, description and the link to the Bandsintown event page

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

Getting Started

• In order to use the Bandsintown API, you must read and accept our Terms and Conditions below and you must have written consent from Bandsintown Inc. Any other use of the Bandsintown API is prohibited. Contact Bandsintown to tell us what you plan to do and request your personal application ID.
• Find out about the API methods available and the format of the API responses below. Select the method you wish to use and try it out online with the app ID provided to you.
• Call our Bandsintown API with the app ID provided straight from your website or back-end platform and choose which element of the API response you wish to display. Scroll to the bottom of this page to find out about the Models used.

Actions

artist

Get artist information

bandsintown.artist({
  "artistname": "",
  "app_id": ""
}, context)

Input

• input object
  • artistname required string: The name of the artist. If it contains one of the special characters below, please be sure to replace it by the corresponding code: for / use %252F, for ? use %253F, for * use %252A, and for " use %27C
  • app_id required string: The application ID assigned to you by Bandsintown

Output

• output ArtistData

artistEvents

artist events

bandsintown.artistEvents({
  "artistname": "",
  "app_id": ""
}, context)

Input

• input object
  • artistname required string: The name of the artist. If it contains one of the special characters below, please be sure to replace it by the corresponding code: for / use %252F, for ? use %253F, for * use %252A, and for " use %27C
  • app_id required string: The application ID assigned to you by Bandsintown
  • date string: Can be one of the following values: "upcoming", "past", "all", or a date range e.g. "2015-05-05,2017-05-05". If not specified, only upcoming shows are returned

Output

• output array
  • items EventData

Definitions

ArtistData

• ArtistData object
  • facebook_page_url required string
  • id integer
  • image_url required string
  • mbid required string
  • name required string
  • thumb_url required string
  • tracker_count required integer
  • upcoming_event_count required integer
  • url required string

EventData

• EventData object
  • artist_id required string
  • datetime required string
  • description string
  • id required string
  • lineup required array
    • items string
  • offers required array
    • items OfferData
  • on_sale_datetime required string
  • url required string
  • venue required VenueData

OfferData

• OfferData object
  • status required string
  • type required string
  • url required string

VenueData

• VenueData object
  • city required string
  • country required string
  • latitude required string
  • longitude required string
  • name required string
  • region required string