Fetch detailed meta data and episodes for a podcast by id
GET {{baseUrl}}/podcasts/:id?next_episode_pub_date=<integer>&sort=recent_first
Fetch detailed meta data and episodes for a specific podcast (up to 10 episodes each time). You can use the nextepisodepub_date parameter to do pagination and fetch more episodes.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
next_episode_pub_date | string | For episodes pagination. It's the value of next_episode_pub_date from the response of last request. If not specified, just return latest 10 episodes or oldest 10 episodes, depending on the value of the sort parameter. | |
sort | string | How do you want to sort the episodes of this podcast? | |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
X-ListenAPI-Key | string | (Required) Get API Key on listennotes.com/api | |
Accept | string |
RESPONSES
status: OK
{"episodes":[{"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"},{"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"}],"is_claimed":"\u003cboolean\u003e","type":"serial","explicit_content":"\u003cboolean\u003e","website":"\u003cstring\u003e","total_episodes":"\u003cinteger\u003e","audio_length_sec":"\u003cinteger\u003e","update_frequency_hours":"\u003cinteger\u003e","earliest_pub_date_ms":"\u003cinteger\u003e","rss":"\u003cstring\u003e","latest_episode_id":"\u003cstring\u003e","latest_pub_date_ms":"\u003cinteger\u003e","title":"\u003cstring\u003e","language":"\u003cstring\u003e","description":"\u003cstring\u003e","email":"\u003cstring\u003e","image":"\u003cstring\u003e","thumbnail":"\u003cstring\u003e","listennotes_url":"\u003cstring\u003e","id":"\u003cstring\u003e","country":"\u003cstring\u003e","publisher":"\u003cstring\u003e","itunes_id":"\u003cinteger\u003e","looking_for":{"cohosts":"\u003cboolean\u003e","cross_promotion":"\u003cboolean\u003e","sponsors":"\u003cboolean\u003e","guests":"\u003cboolean\u003e"},"extra":{"youtube_url":"\u003cstring\u003e","facebook_handle":"\u003cstring\u003e","instagram_handle":"\u003cstring\u003e","twitter_handle":"\u003cstring\u003e","wechat_handle":"\u003cstring\u003e","patreon_handle":"\u003cstring\u003e","google_url":"\u003cstring\u003e","amazon_music_url":"\u003cstring\u003e","linkedin_url":"\u003cstring\u003e","spotify_url":"\u003cstring\u003e","url1":"\u003cstring\u003e","url2":"\u003cstring\u003e","url3":"\u003cstring\u003e"},"genre_ids":["\u003cinteger\u003e","\u003cinteger\u003e"],"next_episode_pub_date":"\u003cinteger\u003e","listen_score":"\u003cinteger\u003e","listen_score_global_rank":"\u003cstring\u003e","has_guest_interviews":"\u003cboolean\u003e","has_sponsors":"\u003cboolean\u003e"}