README.md

In fusionet24/SetListR: Setlist FM API Wrapper

SetListR

Overview

A wrapper for the SetList FM API. To enable easier and quicker analysis of music and artists in R.

Installation

# install.packages("devtools")
devtools::install_github("fusionet24/SetListR")

You will also need an API key which can be generated once you have a setlist fm account.

Usage

There are currently 5 functions that provide access to different endpoints from the Setlist FM API: - getArtist() - getArtistSetLists() - searchArtists() - searchSetLists() - searchCities()

The can be used in a variety of ways and documentation is included within the package. A quick example is:

library(SetListR)
getArtistSetLists(API_KEY = "KEY",mbid = 'aca5718f-4f49-4439-b8f6-209db3f11757') # Replace KEY with your API KEY!
# This queries for setlist from Frank Turner whose Music Brainz ID is the above Unique Indentifer

The MBID is a unique id assigned to every artist by Music Brains. You can use the search Artist function to find them:

library(SetListR)
searchArtists(API_KEY = 'KEY', artistName = 'Frank Turner') # Replace KEY with your API KEY!

You can search specfic setlists by Artist,location etc.

library(SetListR)
searchSetLists(API_KEY = 'KEY', mbid = '0bfba3d3-6a04-4779-bb0a-df07df5b0558', countryCode = 'USA')
searchSetLists(API_KEY = 'KEY', mbid = '0bfba3d3-6a04-4779-bb0a-df07df5b0558', cityName ='Lincoln') # Replace KEY with your API KEY!

You can search specfic cities.

library(SetListR)
searchCities(API_KEY = "KEY",cityName = "Lincoln", countryName = "UK") # Replace KEY with your API KEY!

fusionet24/SetListR documentation built on May 29, 2019, 7:13 a.m.