Skip to content
DocumentationAPI Reference

Playlists

Get Playlist
playlists.retrieve(playlist_id, **kwargs) -> PlaylistRetrieveResponse { id, collaborative, description, 11 more }
GET/playlists/{playlist_id}
Change Playlist Details
playlists.update(playlist_id, **kwargs) -> void
PUT/playlists/{playlist_id}

PlaylistsTracks

Get Playlist Items
playlists.tracks.list(playlist_id, **kwargs) -> CursorURLPage<PlaylistTrackObject { added_at, added_by, is_local, 2 more } >
GET/playlists/{playlist_id}/tracks
Add Items to Playlist
playlists.tracks.add(playlist_id, **kwargs) -> TrackAddResponse { snapshot_id }
POST/playlists/{playlist_id}/tracks
Update Playlist Items
playlists.tracks.update(playlist_id, **kwargs) -> TrackUpdateResponse { snapshot_id }
PUT/playlists/{playlist_id}/tracks
Remove Playlist Items
playlists.tracks.remove(playlist_id, **kwargs) -> TrackRemoveResponse { snapshot_id }
DELETE/playlists/{playlist_id}/tracks

PlaylistsFollowers

Follow Playlist
playlists.followers.follow(playlist_id, **kwargs) -> void
PUT/playlists/{playlist_id}/followers
Unfollow Playlist
playlists.followers.unfollow(playlist_id) -> void
DELETE/playlists/{playlist_id}/followers
Check if Current User Follows Playlist
playlists.followers.check(playlist_id, **kwargs) -> FollowerCheckResponse
GET/playlists/{playlist_id}/followers/contains

PlaylistsImages

Get Playlist Cover Image
playlists.images.list(playlist_id) -> ImageListResponse { height, url, width, published }
GET/playlists/{playlist_id}/images
Add Custom Playlist Cover Image
playlists.images.update(playlist_id, **kwargs) -> StringIO
PUT/playlists/{playlist_id}/images