Full-text search on episodes, podcasts, or curated lists of podcasts.
Use the offset parameter to paginate through search results.
The FREE plan allows to see up to 30 search results (or offset < 30) per query.
The PRO plan allows to see up to 300 search results (or offset < 300) per query.
The ENTERPRISE plan allows to see up to 10,000 search results (or offset < 10000) per query.
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
Full-text search
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
- 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
{
"type": "object",
"properties": {
"X-ListenAPI-Key": {
"type": "string"
},
"episode_count_max": {
"type": "integer"
},
"episode_count_min": {
"type": "integer"
},
"genre_ids": {
"type": "string"
},
"language": {
"type": "string"
},
"len_max": {
"type": "integer"
},
"len_min": {
"type": "integer"
},
"ncid": {
"type": "string"
},
"ocid": {
"type": "string"
},
"offset": {
"type": "integer"
},
"only_in": {
"type": "string"
},
"published_after": {
"type": "integer"
},
"published_before": {
"type": "integer"
},
"q": {
"type": "string"
},
"region": {
"type": "string"
},
"safe_mode": {
"type": "integer",
"enum": [
0,
1
]
},
"sort_by_date": {
"type": "integer",
"enum": [
0,
1
]
},
"type": {
"type": "string",
"enum": [
"episode",
"podcast",
"curated"
]
},
"unique_podcasts": {
"type": "integer",
"enum": [
0,
1
]
},
"update_freq_max": {
"type": "integer"
},
"update_freq_min": {
"type": "integer"
}
},
"required": [
"X-ListenAPI-Key",
"q"
],
"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
{
"type": "object",
"properties": {
"count": {
"type": "integer",
"description": "The number of search results in this page."
},
"next_offset": {
"type": "integer",
"description": "Pass this value to the **offset** parameter to do pagination of search results."
},
"results": {
"type": "array",
"description": "A list of search results.",
"items": {
"type": "object"
}
},
"took": {
"type": "number",
"description": "The time it took to fetch these search results. In seconds."
},
"total": {
"type": "integer",
"description": "The total number of search results."
}
}
}