##### Getting started

Introduction Usage Policy Endpoints & Versioning Authentication

##### Open APIs

Discovery Promos Songs Users Tournaments

##### Connect APIs

Connect

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

On this page
Search Search All New Songs Hot Songs Popular Songs