Playlists

July 12, 2026 ยท View on GitHub

Provides the list of the user's playlists.

Request

{
    "id": 1,
    "type": "spotcast/playlists",
    "account": "01JDG07KSBTYWZGJSBJ1EW6XEF",
    "limit": 20
}

id (int)

Required

The id of the transaction. Must be an increment of the last transaction id.

type (str)

Required

The endpoint of the WebSocket to reach. Must be spotcast/playlists.

account (str)

Optional

The entry_id of the account to use. Defaults to the default Spotcast account if not provided.

limit (int)

Optional

Limits the number of playlists retrieved. Retrieves all playlists if not provided.

Response

{
    "id": 1,
    "type": "result",
    "success": true,
    "result": {
        "total": 20,
        "account": "01JDG07KSBTYWZGJSBJ1EW6XEF",
        "category": "user",
        "playlists": [
            {},
            {}
        ]
    }
}

id (int)

The id provided in the request.

type (str)

Always result on a successful request.

success (bool)

true if the transaction was successful.

result (dict)

The result of the transaction.

total (int)

The number of playlists retrieved.

account (str)

The id of the account used in the query.

category (str)

Always user. Kept for backward compatibility with earlier versions that supported Browse category drilldown (removed after Spotify deprecated the category playlists endpoint).

playlists (list[dict])

The user's playlists. These are the raw Spotify playlist objects; see Get Playlist for the fields.