Fetch a playlist's info and items (i.e., episodes or podcasts).
GET {{baseUrl}}/playlists/:id?type=episode_list&last_timestamp_ms=0&sort=recent_added_first
A playlist can be an episode list (i.e., all items are episodes) or a podcast list (i.e., all items are podcasts), which is essentially the same as those created via listennotes.com/listen/. This endpoint fetches a list of items (i.e., episodes or podcasts) in the playlist. You can use the lastpubdate_ms parameter to do pagination and fetch more items. A playlist can be public (discoverable on ListenNotes.com), unlisted (accessible to anyone who knows the playlist id), or private (accessible to its owner). You can fetch all playlists created by you, and public / unlisted playlists created by others.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
type | string | The type of this playlist, which should be either episode_list or podcast_list. | |
last_timestamp_ms | number | For playlist items pagination. | |
| It's the value of last_timestamp_ms from the response of last request. | |||
| If it's 0 or not specified, just return the latest or the oldest 20 items, | |||
| depending on the value of the sort parameter. | |||
sort | string | How do you want to sort playlist items? | |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
X-ListenAPI-Key | string | (Required) Get API Key on listennotes.com/api | |
Accept | string |
RESPONSES
status: OK
{"id":"\u003cstring\u003e","name":"\u003cstring\u003e","description":"\u003cstring\u003e","image":"\u003cstring\u003e","thumbnail":"\u003cstring\u003e","listennotes_url":"\u003cstring\u003e","visibility":"public","last_timestamp_ms":"\u003cinteger\u003e","total":"\u003cinteger\u003e","total_audio_length_sec":"\u003cinteger\u003e","type":"podcast_list","items":[{"id":"\u003cinteger\u003e","type":"episode","notes":"\u003cstring\u003e","added_at_ms":"\u003cinteger\u003e","data":{"maybe_audio_invalid":"\u003cboolean\u003e","pub_date_ms":"\u003cinteger\u003e","audio":"\u003cstring\u003e","listennotes_edit_url":"\u003cstring\u003e","image":"\u003cstring\u003e","thumbnail":"\u003cstring\u003e","description":"\u003cstring\u003e","title":"\u003cstring\u003e","explicit_content":"\u003cboolean\u003e","listennotes_url":"\u003cstring\u003e","audio_length_sec":"\u003cinteger\u003e","id":"\u003cstring\u003e","link":"\u003cstring\u003e","podcast":{"image":"\u003cstring\u003e","thumbnail":"\u003cstring\u003e","title":"\u003cstring\u003e","listennotes_url":"\u003cstring\u003e","id":"\u003cstring\u003e","publisher":"\u003cstring\u003e","listen_score":"\u003cinteger\u003e","listen_score_global_rank":"\u003cstring\u003e"}}},{"id":"\u003cinteger\u003e","type":"custom_audio","notes":"\u003cstring\u003e","added_at_ms":"\u003cinteger\u003e","data":{"maybe_audio_invalid":"\u003cboolean\u003e","pub_date_ms":"\u003cinteger\u003e","audio":"\u003cstring\u003e","listennotes_edit_url":"\u003cstring\u003e","image":"\u003cstring\u003e","thumbnail":"\u003cstring\u003e","description":"\u003cstring\u003e","title":"\u003cstring\u003e","explicit_content":"\u003cboolean\u003e","listennotes_url":"\u003cstring\u003e","audio_length_sec":"\u003cinteger\u003e","id":"\u003cstring\u003e","link":"\u003cstring\u003e","podcast":{"image":"\u003cstring\u003e","thumbnail":"\u003cstring\u003e","title":"\u003cstring\u003e","listennotes_url":"\u003cstring\u003e","id":"\u003cstring\u003e","publisher":"\u003cstring\u003e","listen_score":"\u003cinteger\u003e","listen_score_global_rank":"\u003cstring\u003e"}}}]}