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_
.