Skip to content
DocumentationAPI Reference

Check User's Saved Episodes

client.me.episodes.check(EpisodeCheckParams { ids } query, RequestOptionsoptions?): 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
query: EpisodeCheckParams { ids }
ids: string

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

ReturnsExpand Collapse
EpisodeCheckResponse = Array<boolean>

Check User's Saved Episodes

import Spotted from 'spotted-ts';

const client = new Spotted({
  accessToken: process.env['SPOTIFY_ACCESS_TOKEN'], // This is the default and can be omitted
});

const response = await client.me.episodes.check({
  ids: '77o6BIVlYM3msb4MMIL1jH,0Q86acNRm6V9GYx55SXKwf',
});

console.log(response);
[
  false,
  true
]
Returns Examples
[
  false,
  true
]