Discovery

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