#Welly Splosher API
##Description Provides refined music festival data based on listening data from a Last.Fm or Spotify account. Lineup and Rumour data is care of efestivals.co.uk, and schedule data care of clashfinder.com
##Endpoints
Get artists linked with festival that match those in Last.Fm user's listening history
/{festival}/{year}/{username}
- festival
- The festival key dictated by efestivals, e.g. for Glastonbury, use glastonbury. For V Festival, prefix with 'vvv'
- year
- Year of festival data. 2015 if not specified
- username
- A valid Last.Fm username
Get artists linked with festival that are recommended based on Last.Fm user's listening history
/rec/{festival}/{year}/{username}
- festival
- The festival key dictated by efestivals, e.g. for Glastonbury, use glastonbury. For V Festival, prefix with 'vvv'
- year
- Year of festival data. 2015 if not specified
- username
- A valid Last.Fm username
Get artists linked with festival that are recommended based on Spotify user's owned playlists and saved tracks
/spotify/{festival}/{year}/{code}/{redirectUrl}
- festival
- The festival key dictated by efestivals, e.g. for Glastonbury, use glastonbury. For V Festival, prefix with 'vvv'
- year
- Year of festival data. 2015 if not specified
- code
- Spotify Authorization Code
- redirectUrl
- Redirect URL used in acquiring Authorization Code
Get artists linked with festival that are recommended based on Spotify user's owned playlists and saved tracks
/spotify/rec/{festival}/{year}/{code}/{redirectUrl}
- festival
- The festival key dictated by efestivals, e.g. for Glastonbury, use glastonbury. For V Festival, prefix with 'vvv'
- year
- Year of festival data. 2015 if not specified
- code
- Spotify Authorization Code
- redirectUrl
- Redirect URL used in acquiring Authorization Code
[
{
"name": "Frank Turner",
"day": "Saturday",
"stage": "Other Stage",
"status": "Confirmed",
"scrobs": "359",
"recrank": 32
},
{
"name": "Nick Lowe, Paul Carrack & Andy Fairweather Low",
"day": "Saturday",
"stage": "Acoustic Tent",
"status": "Confirmed",
"scrobs": "39",
"recrank": 176,
"matchString": "Paul Carrack"
}
]
Generate personalised schedule based on Last.Fm listening history
/s/{festival}/{year}/{username}
- festival
- The festival key dictated by clashfinder, e.g. for Glastonbury, use g. For V Festival, prefix with 'vvv'
- year
- Year of festival data. 2015 if not specified
- username
- A valid Last.Fm username
Generate personalised schedule from recommended artists based on Last.Fm user's listening history
/s/rec/{festival}/{year}/{username}
- festival
- The festival key dictated by clashfinder, e.g. for Glastonbury, use g. For V Festival, prefix with 'vvv'
- year
- Year of festival data. 2015 if not specified
- username
- A valid Last.Fm username
Generate hybrid personalised schedule from Last.Fm user's listening history and recommended artists
/s/h/{strategy}/{festival}/{year}/{username}
- strategy
- 'listened' to prefer listened artists in schedule, 'recco' to prefer recommended, no other values valid
- festival
- The festival key dictated by clashfinder, e.g. for Glastonbury, use g. For V Festival, prefix with 'vvv'
- year
- Year of festival data. 2015 if not specified
- username
- A valid Last.Fm username
Generate personalised schedule based on Spotify user's owned playlists and saved tracks
/s/spotify/{festival}/{year}/{authcode}/{redirectUrl}
- festival
- The festival key dictated by clashfinder, e.g. for Glastonbury, use g. For V Festival, prefix with 'vvv'
- year
- Year of festival data. 2015 if not specified
- authcode
- Spotify Authorization Code
- redirectUrl
- Redirect URL used in acquiring Authorization Code
Generate personalised schedule from recommended artists based on Spotify user's owned playlists and saved tracks
/s/spotify/rec/{festival}/{year}/{authcode}/{redirectUrl}
- festival
- The festival key dictated by clashfinder, e.g. for Glastonbury, use g. For V Festival, prefix with 'vvv'
- year
- Year of festival data. 2015 if not specified
- authcode
- Spotify Authorization Code
- redirectUrl
- Redirect URL used in acquiring Authorization Code
Generate hybrid personalised schedule from Spotify user's owned playlists, saved tracks and recommended artists
/s/h/spotify/{strategy}/{festival}/{year}/{authcode}/{redirectUrl}
- strategy
- 'listened' to prefer listened artists in schedule, 'recco' to prefer recommended, no other values valid
- festival
- The festival key dictated by clashfinder, e.g. for Glastonbury, use g. For V Festival, prefix with 'vvv'
- year
- Year of festival data. 2015 if not specified
- authcode
- Spotify Authorization Code
- redirectUrl
- Redirect URL used in acquiring Authorization Code
{
"sched": {
"Friday": [
{
"name": "Bastille",
"stage": "Main Stage",
"day": "Friday",
"startTime": "18:10",
"endTime": "19:10",
"scrobs": 26,
"ttStart": "7.1667",
"ttDuration": "1.0000",
"reccorank": -1,
"start": 1440781800000,
"end": 1440785400000
},
{
"name": "Mumford & Sons",
"stage": "Main Stage",
"day": "Friday",
"startTime": "21:30",
"endTime": "23:30",
"scrobs": 231,
"ttStart": "10.5000",
"ttDuration": "2.0000",
"reccorank": -1,
"start": 1440793800000,
"end": 1440801000000
}
],
"Saturday": [
{
"name": "Twin Atlantic",
"stage": "NME",
"day": "Saturday",
"startTime": "21:10",
"endTime": "22:00",
"scrobs": 72,
"ttStart": "10.1667",
"ttDuration": "0.8333",
"reccorank": -1,
"start": 1440879000000,
"end": 1440882000000
}
],
"Sunday": [
{
"name": "Frank Turner (Solo)",
"stage": "Festival Republic",
"day": "Sunday",
"startTime": "21:35",
"endTime": "22:35",
"scrobs": 359,
"ttStart": "10.5833",
"ttDuration": "1.0000",
"reccorank": -1,
"matchString": "Frank Turner",
"start": 1440966900000,
"end": 1440970500000
}
]
},
"clash": {
"Friday": [
{
"name": "Limp Bizkit",
"stage": "NME",
"day": "Friday",
"startTime": "21:10",
"endTime": "22:10",
"scrobs": 55,
"ttStart": "10.1667",
"ttDuration": "1.0000",
"reccorank": -1,
"start": 1440792600000,
"end": 1440796200000
}
]
}
}
##Notes