Songs

Detail

Returns more detailled information about a song.

Method GET
Endpoint /song/songID


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


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


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