Fetch detailed meta data for an episode by id
GET {{baseUrl}}/episodes/:id?show_transcript=0
Fetch detailed meta data for a specific episode.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
show_transcript | number | To include the transcript of this episode or not? If it is 1, then include the transcript in the transcript field. The default value is 0 - we don't include transcript by default, because 1) it would make the response data very big, thus slow response time; 2) less than 1% of episodes have transcripts. The transcript field is available only in the PRO/ENTERPRISE plan. |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
X-ListenAPI-Key | string | (Required) Get API Key on listennotes.com/api | |
Accept | string |
RESPONSES
status: OK
{"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","podcast":{"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"],"listen_score":"\u003cinteger\u003e","listen_score_global_rank":"\u003cstring\u003e","has_guest_interviews":"\u003cboolean\u003e","has_sponsors":"\u003cboolean\u003e"},"link":"\u003cstring\u003e","transcript":"\u003cstring\u003e"}