This endpoint returns same data as listennotes.com/listen under your account. You can use the page parameter to do pagination and fetch more playlists.
643 matches
21 actions
Listen API: Podcast Search, Directory, and Insights
21 actions
- Fetch a curated list of podcasts by idGETv1.0.0
- Fetch a list of best podcasts by genreGETv1.0.0
- Fetch a list of podcast genresGETv1.0.0
- Fetch a list of supported countries/regions for best podcastsGETv1.0.0
- Fetch a list of supported languages for podcastsGETv1.0.0
- Fetch a list of your playlists.GETv1.0.0
- Fetch a playlist's info and items (i.e., episodes or podcasts).GETv1.0.0
- Fetch a random podcast episodeGETv1.0.0
- Fetch audience demographics for a podcastGETv1.0.0
- Fetch curated lists of podcastsGETv1.0.0
- Fetch detailed meta data and episodes for a podcast by idGETv1.0.0
- Fetch detailed meta data for an episode by idGETv1.0.0
- Fetch recommendations for a podcastGETv1.0.0
- Fetch recommendations for an episodeGETv1.0.0
- Fetch related search termsGETv1.0.0
- Fetch trending search termsGETv1.0.0
- Full-text searchGETv1.0.0
- Request to delete a podcastDELETEv1.0.0
- Spell check on a search termGETv1.0.0
- Submit a podcast to Listen Notes databasePOSTv1.0.0
- Typeahead searchGETv1.0.0
Other/Listen API: Podcast Search, Directory, and Insights
Fetch a list of your playlists.
v1.0.0Input
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
- 23
- 24
{
"type": "object",
"properties": {
"X-ListenAPI-Key": {
"type": "string"
},
"page": {
"type": "integer"
},
"sort": {
"type": "string",
"enum": [
"recent_added_first",
"oldest_added_first",
"name_a_to_z",
"name_z_to_a"
]
}
},
"required": [
"X-ListenAPI-Key"
],
"additionalProperties": false
}Output
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
- 23
- 24
- 25
- 26
- 27
- 28
- 29
- 30
- 31
- 32
- 33
- 34
- 35
- 36
- 37
- 38
- 39
- 40
- 41
- 42
- 43
- 44
- 45
- 46
- 47
- 48
- 49
- 50
- 51
- 52
- 53
- 54
- 55
- 56
- 57
- 58
- 59
- 60
- 61
- 62
- 63
- 64
- 65
- 66
- 67
- 68
- 69
- 70
- 71
- 72
- 73
- 74
- 75
- 76
- 77
- 78
- 79
- 80
- 81
{
"type": "object",
"properties": {
"has_next": {
"type": "boolean"
},
"has_previous": {
"type": "boolean"
},
"next_page_number": {
"type": "integer"
},
"page_number": {
"type": "integer"
},
"playlists": {
"type": "array",
"items": {
"type": "object",
"description": "A playlist",
"properties": {
"description": {
"type": "string",
"description": "Playlist description."
},
"episode_count": {
"type": "integer",
"description": "The number of episodes (including custom audio) in this playlist."
},
"id": {
"type": "string",
"description": "A 11-character playlist id, which can be used to further fetch detailed playlist metadata via `GET /playlists/{id}`."
},
"image": {
"type": "string",
"description": "High resolution image url of the playlist."
},
"last_timestamp_ms": {
"type": "integer",
"description": "Passed to the **last_timestamp_ms** parameter of `GET /playlists/{id}` to paginate through items of that playlist.\n"
},
"listennotes_url": {
"type": "string",
"description": "The url of this playlist on ListenNotes.com."
},
"name": {
"type": "string",
"description": "Playlist name."
},
"podcast_count": {
"type": "integer",
"description": "The number of podcasts in this playlist."
},
"thumbnail": {
"type": "string",
"description": "Low resolution image url of the playlist."
},
"total_audio_length_sec": {
"type": "integer",
"description": "Total audio length of all episodes in this playlist, in seconds."
},
"visibility": {
"type": "string",
"description": "Visibility of this playlist.",
"enum": [
"public",
"unlisted",
"private"
]
}
}
}
},
"previous_page_number": {
"type": "integer"
},
"total": {
"type": "integer"
}
}
}