Skip to content
DocumentationAPI Reference

Check User's Saved Episodes

me.episodes.check(EpisodeCheckParams**kwargs) -> EpisodeCheckResponse
GET/me/episodes/contains

Check if one or more episodes is already saved in the current Spotify user's 'Your Episodes' 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: str

A comma-separated list of the Spotify IDs for the episodes. Maximum: 50 IDs.

ReturnsExpand Collapse
List[bool]

Check User's Saved Episodes

import os
from spotted import Spotted

client = Spotted(
    access_token=os.environ.get("SPOTIFY_ACCESS_TOKEN"),  # This is the default and can be omitted
)
response = client.me.episodes.check(
    ids="77o6BIVlYM3msb4MMIL1jH,0Q86acNRm6V9GYx55SXKwf",
)
print(response)
[
  false,
  true
]
Returns Examples
[
  false,
  true
]