Search + K

Command Palette

Search for a command to run...

Sign In

Get User's Saved Episodes

GET /me/episodes
Copy endpoint
https://api.spotify.com/v1

Get a list of the episodes saved in the current Spotify 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.

Parameters

query Query Parameters

Name Type
market
string
limit
number
offset
number

Responses

200 application/json

Pages of episodes

type PagingSavedEpisodeObject = never

Client Errors

401 application/json

Bad or expired token. This can happen if the user revoked a token or the access token has expired. You should re-authenticate the user.

{ error: ErrorObject
interface ErrorObject {
status: number;
message: string;
}
; }
403 application/json

Bad OAuth request (wrong consumer key, bad nonce, expired timestamp...). Unfortunately, re-authenticating the user won't help here.

{ error: ErrorObject
interface ErrorObject {
status: number;
message: string;
}
; }
429 application/json

The app has exceeded its rate limits.

{ error: ErrorObject
interface ErrorObject {
status: number;
message: string;
}
; }