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":[]
}