Discovery
Search
Returns songs and users based on the searchQuery
provided.
Method | GET |
---|---|
Endpoint | /search/searchQuery |
Output Body
{ "version":1, "status":200, "data":{ "users":[ { "id":4, "username":"thatanimeweirdo", "isVerified":true, "isPatreon":null, "avatar":"https:\/\/spinsha.re\/uploads\/avatar\/5ef8cddb50106.png" }, ... ], "songs":[ { "id":1024, "title":"Keyboard Combos XD", "subtitle":"Charted in XD because WHY NOT", "artist":"Discord", "charter":"Raoul1808", "hasEasyDifficulty":false, "hasNormalDifficulty":false, "hasHardDifficulty":false, "hasExtremeDifficulty":false, "hasXDDifficulty":true, "cover":"https:\/\/spinsha.re\/uploads\/thumbnail\/spinshare_5f2d157f6e44a.jpg", "zip":"https:\/\/spinsha.re\/api\/song\/1024\/download" }, ... ] } }
Search All
Returns all songs and users.
Method | GET |
---|---|
Endpoint | /searchAll |
Output Body
{ "version":1, "status":200, "data":{ "users":[ { "id":4, "username":"thatanimeweirdo", "isVerified":true, "isPatreon":null, "avatar":"https:\/\/spinsha.re\/uploads\/avatar\/5ef8cddb50106.png" }, ... ], "songs":[ { "id":1024, "title":"Keyboard Combos XD", "subtitle":"Charted in XD because WHY NOT", "artist":"Discord", "charter":"Raoul1808", "hasEasyDifficulty":false, "hasNormalDifficulty":false, "hasHardDifficulty":false, "hasExtremeDifficulty":false, "hasXDDifficulty":true, "cover":"https:\/\/spinsha.re\/uploads\/thumbnail\/spinshare_5f2d157f6e44a.jpg", "zip":"https:\/\/spinsha.re\/api\/song\/1024\/download" }, ... ] } }
New Songs
Returns the 12 newest songs. Use offset
for pagination.
Method | GET |
---|---|
Endpoint | /songs/new/offset |
Output Body (Success)
{ "version":1, "status":200, "data":[ { "id": 3, "title": "Isabelle Singing", "subtitle": "K.K. Bubblegum", "artist": "K.K. Slider", "charter": "Ellite", "hasEasyDifficulty": false, "hasNormalDifficulty": false, "hasHardDifficulty": true, "hasExtremeDifficulty": false, "hasXDDifficulty": false, "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":[] }
Hot Songs
Returns the 12 most popular songs from the last 7 days. Use offset
for pagination.
Method | GET |
---|---|
Endpoint | /songs/hot/offset |
Output Body (Success)
{ "version":1, "status":200, "data":[ { "id": 3, "title": "Isabelle Singing", "subtitle": "K.K. Bubblegum", "artist": "K.K. Slider", "charter": "Ellite", "hasEasyDifficulty": false, "hasNormalDifficulty": false, "hasHardDifficulty": true, "hasExtremeDifficulty": false, "hasXDDifficulty": false, "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":[] }
Popular Songs
Returns the 12 most popular songs of all time. Use offset
for pagination.
Method | GET |
---|---|
Endpoint | /songs/popular/offset |
Output Body (Success)
{ "version":1, "status":200, "data":[ { "id": 3, "title": "Isabelle Singing", "subtitle": "K.K. Bubblegum", "artist": "K.K. Slider", "charter": "Ellite", "hasEasyDifficulty": false, "hasNormalDifficulty": false, "hasHardDifficulty": true, "hasExtremeDifficulty": false, "hasXDDifficulty": false, "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":[] }