Songs
Detail
Returns more detailled information about a song.
| Method | GET |
|---|---|
| Endpoint | /song/songID |
Information
Instead of asongID you can also provide a fileReference, which start with spinshare_.
Output Body
{
"version":1,
"status":200,
"data":{
"id":3,
"title":"Isabelle Singing",
"subtitle":"K.K. Bubblegum",
"artist":"K.K. Slider",
"charter":"Ellite",
"uploader":3,
"fileReference":"spinshare_5e8df6fb90bd7",
"tags":[
"isabelle",
"singing",
"easy",
"cute",
"animal",
"crossing",
"acnh",
"new",
"horizons"
],
"views":774,
"downloads":98,
"isExplicit":false,
"isTournament":false,
"hasEasyDifficulty":false,
"hasNormalDifficulty":false,
"hasHardDifficulty":true,
"hasExtremeDifficulty":false,
"hasXDDifficulty":false,
"uploadDate":{
"date":"2020-05-01 00:00:00.000000",
"timezone_type":3,
"timezone":"Europe\/Berlin"
},
"description":null,
"paths":{
"ogg":"https:\/\/spinsha.re\/uploads\/audio\/spinshare_5e8df6fb90bd7_0.ogg",
"cover":"https:\/\/spinsha.re\/uploads\/thumbnail\/spinshare_5e8df6fb90bd7.jpg",
"zip":"https:\/\/spinsha.re\/api\/song\/3\/download"
}
}
}
Output Body (Not Found)
{
"version":1,
"status":404,
"data":[]
}
Reviews
Returns all active reviews of a song.
| Method | GET |
|---|---|
| Endpoint | /song/songID/reviews |
Information
Instead of asongID you can also provide a fileReference, which start with spinshare_.
Output Body
{
"version":1,
"status":200,
"data":{
"average":91.7,
"reviews":[
{
"id":632,
"user":{
"id":47,
"username":"NicolasPL",
"coverReference":"5e98e02997f6c.png",
"isVerified":null,
"isPatreon":null
},
"recommended":true,
"comment":"Really good. I played it on Expert, really fun.",
"reviewDate":{
"date":"2020-08-03 01:19:43.000000",
"timezone_type":3,
"timezone":"Europe\/Berlin"
}
},
...
]
}
}
SpinPlays
Returns all active SpinPlays of a song.
| Method | GET |
|---|---|
| Endpoint | /song/songID/spinplays |
Information
Instead of asongID you can also provide a fileReference, which start with spinshare_.
Output Body
{
"version":1,
"status":200,
"data":{
"spinPlays":[
{
"id":150,
"user":{
"id":20,
"username":"Zick407",
"coverReference":"5e9935a0afa55.png",
"isVerified":false,
"isPatreon":null
},
"videoUrl":"https:\/\/www.youtube.com\/watch?v=bEVdyM5_qxA",
"videoThumbnail":"https:\/\/i.ytimg.com\/vi\/bEVdyM5_qxA\/maxresdefault.jpg",
"submitDate":{
"date":"2020-07-01 02:10:39.000000",
"timezone_type":3,
"timezone":"Europe\/Berlin"
},
"isActive":true
}
]
}
}
Download
Generates a download zip and returns it.
| Method | GET |
|---|---|
| Endpoint | /song/songID/download |
Information
Instead of asongID you can also provide a fileReference, which start with spinshare_.