##### Getting started

Introduction Usage Policy Endpoints & Versioning Authentication

##### Open APIs

Discovery Promos Songs Users Tournaments

##### Connect APIs

Connect

# Songs

## Detail

Returns more detailled information about a song.

Method | GET
Endpoint | /song/`songID`

#### Information

Instead of a `songID` 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 a `songID` 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 a `songID` 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 a `songID` you can also provide a `fileReference`, which start with `spinshare_`.

#### Information

This API endpoint returns a zip attachment as a Spin Rhythm XD backup.
On this page
Detail Reviews SpinPlays Download