Recently published episodes are more likely to be fetched. Good luck!
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 random podcast episode
v1.0.0Input
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
{
"type": "object",
"properties": {
"X-ListenAPI-Key": {
"type": "string"
}
},
"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
- 82
- 83
- 84
- 85
- 86
- 87
- 88
- 89
- 90
- 91
- 92
- 93
- 94
{
"type": "object",
"properties": {
"audio": {
"type": "string",
"description": "Audio url of this episode, which can be played directly."
},
"audio_length_sec": {
"type": "integer",
"description": "Audio length of this episode. In seconds."
},
"description": {
"type": "string",
"description": "Html of this episode's full description"
},
"explicit_content": {
"type": "boolean",
"description": "Whether this podcast contains explicit language."
},
"id": {
"type": "string",
"description": "Episode id, which can be used to further fetch detailed episode metadata via `GET /episodes/{id}`."
},
"image": {
"type": "string",
"description": "Image url for this episode.\nIf an episode doesn't have its own image, then this field would be the url of the podcast artwork image.\nIf you are using PRO/ENTERPRISE plan, then it's\na high resolution image (1400x1400). If you are using FREE plan, then it's the same as **thumbnail**,\nlow resolution image (300x300).\n"
},
"link": {
"type": "string",
"description": "Web link of this episode."
},
"listennotes_edit_url": {
"type": "string",
"description": "Edit url of this episode where you can update the audio url if you find the audio is broken."
},
"listennotes_url": {
"type": "string",
"description": "The url of this episode on [ListenNotes.com](https://www.ListenNotes.com)."
},
"maybe_audio_invalid": {
"type": "boolean",
"description": "Whether or not this episode's audio is invalid. Podcasters may delete the original audio."
},
"podcast": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Podcast id, which can be used to further fetch detailed podcast metadata via `GET /podcasts/{id}`."
},
"image": {
"type": "string",
"description": "Image url for this podcast's artwork. If you are using PRO/ENTERPRISE plan, then it's\na high resolution image (1400x1400). If you are using FREE plan, then it's the same as **thumbnail**,\nlow resolution image (300x300).\n"
},
"listen_score": {
"type": "integer",
"description": "The estimated popularity score of a podcast compared to all other rss-based public podcasts in the world on a scale from 0 to 100.\nIf the score is not available, it'll be null. Learn more at listennotes.com/listen-score\n"
},
"listen_score_global_rank": {
"type": "string",
"description": "The estimated popularity ranking of a podcast compared to all other rss-based public podcasts in the world.\nFor example, if the value is 0.5%, then this podcast is one of the top 0.5% most popular shows out of all podcasts globally, ranked by Listen Score.\nIf the ranking is not available, it'll be null. Learn more at listennotes.com/listen-score\n"
},
"listennotes_url": {
"type": "string",
"description": "The url of this podcast on [ListenNotes.com](https://www.ListenNotes.com)."
},
"publisher": {
"type": "string",
"description": "Podcast publisher name."
},
"thumbnail": {
"type": "string",
"description": "Thumbnail image url for this podcast's artwork (300x300)."
},
"title": {
"type": "string",
"description": "Podcast name."
}
}
},
"pub_date_ms": {
"type": "integer",
"description": "Published date for this episode. In millisecond."
},
"thumbnail": {
"type": "string",
"description": "Thumbnail image (300x300) url for this episode.\nIf an episode doesn't have its own image, then this field would be the url of the podcast artwork thumbnail image.\n"
},
"title": {
"type": "string",
"description": "Episode name."
}
}
}