Skip to content
Spotted Docs Spotted Docs
DocumentationAPI Reference
API Reference
Me
Episodes

Save Episodes for Current User

me.episodes.save(EpisodeSaveParams**kwargs)
PUT/me/episodes

Save one or more episodes to the current user's library.
This API endpoint is in beta and could change without warning. Please share any feedback that you have, or issues that you discover, in our developer community forum.

ParametersExpand Collapse
ids: SequenceNotStr[str]

A JSON array of the Spotify IDs.
A maximum of 50 items can be specified in one request. Note: if the ids parameter is present in the query string, any IDs listed here in the body will be ignored.

published: Optional[bool]

The playlist's public/private status (if it should be added to the user's profile or not): true the playlist will be public, false the playlist will be private, null the playlist status is not relevant. For more about public/private status, see Working with Playlists

Save Episodes for Current User 

import os
from spotted import Spotted

client = Spotted(
    access_token=os.environ.get("SPOTIFY_ACCESS_TOKEN"),  # This is the default and can be omitted
)
client.me.episodes.save(
    ids=["string"],
)
Returns Examples