New to Corsair? See API access, authentication, and error handling.
Curated
get
curated.get
Fetch a curated list of podcasts by ID
Risk: read
Output
podcasts full type
podcasts full type
list
curated.list
Fetch curated lists of podcasts
Risk: read
Output
curated_lists full type
curated_lists full type
Episodes
get
episodes.get
Fetch detailed metadata for an episode by ID
Risk: read
show_transcript: 1 requests a transcript when available; transcript data requires a PRO or ENTERPRISE plan.
Output
podcast full type
podcast full type
getBatch
episodes.getBatch
Fetch basic metadata for up to 10 episodes
Risk: read
Supports up to 10 episode IDs and is available only on PRO and ENTERPRISE plans.
Output
episodes full type
episodes full type
getRecommendations
episodes.getRecommendations
Fetch recommended episodes based on a given episode ID
Risk: read
Output
recommendations full type
recommendations full type
justListen
episodes.justListen
Fetch a random recently published podcast episode
Risk: read
podcast full type
podcast full type
Genres
list
genres.list
Fetch a list of podcast genres supported by Listen Notes
Risk: read
Output
genres full type
genres full type
Languages
list
languages.list
Fetch languages supported by the Listen Notes directory
Risk: read
Playlists
addItem
playlists.addItem
Add an episode or podcast to a playlist
Risk: write
Supply exactly one 32-character episode ID or podcast ID. Existing active items are reused; the operation can restore deleted items.
Output
create
playlists.create
Create a playlist owned by the authenticated API account
Risk: write
Creates an empty playlist owned by the API admin. Playlist changes require ownership by that admin account; contributor membership is not sufficient.
Output
delete
playlists.delete
Permanently delete a playlist and its saved references
Risk: destructive
Permanently deletes an owned playlist and its saved references. This cannot be undone; require an explicit confirmation before calling it.
Output
deleteItem
playlists.deleteItem
Remove an episode or podcast reference from a playlist
Risk: destructive
Removes the playlist reference (not the episode or podcast). Only playlists owned by the API admin can be modified.
Output
get
playlists.get
Fetch a playlist and its items by ID
Risk: read
A playlist can hold both episodes and podcasts. Use
type to choose the view and last_timestamp_ms from the response to paginate.
Output
items full type
items full type
list
playlists.list
Fetch a list of user playlists
Risk: read
sort supports name_a_to_z and name_z_to_a; page paginates through playlists.
Output
playlists full type
playlists full type
update
playlists.update
Update playlist metadata or its saved default view
Risk: write
Updates at least one of name, description, visibility, or type. Switching to private rotates the playlist RSS secret.
Output
updateItem
playlists.updateItem
Update notes attached to a playlist item
Risk: write
Replaces item notes; an empty string clears them. Only playlists owned by the API admin can be modified.
Output
Podcasts
delete
podcasts.delete
Request removal of a podcast from the Listen Notes directory
Risk: destructive
This submits a podcast deletion request, which Listen Notes reviews within 12 hours. The provider documents
reason: testing as a way to test without deleting; otherwise confirm the request before use.
Output
get
podcasts.get
Fetch detailed metadata and episodes for a podcast by ID
Risk: read
The response includes up to 10 episodes. Use
next_episode_pub_date from the response to paginate; an empty episodes array means there are no more.
Output
looking_for full type
looking_for full type
extra full type
extra full type
episodes full type
episodes full type
getAudience
podcasts.getAudience
Fetch available audience region demographics for a podcast
Risk: read
Audience estimates are available only for some podcasts; an empty response is valid when the provider has no regional data.
Output
by_regions full type
by_regions full type
getBatch
podcasts.getBatch
Fetch basic metadata for up to 10 podcasts by supported IDs
Risk: read
POSTs form-encoded selectors and supports up to 10 podcasts. This endpoint is available only on PRO and ENTERPRISE plans; supply at least one selector (
ids, rsses, itunes_ids, or spotify_ids). With show_latest_episodes: 1, pass next_episode_pub_date from the response to paginate the latest episodes.
Output
podcasts full type
podcasts full type
latest_episodes full type
latest_episodes full type
getBest
podcasts.getBest
Fetch best podcasts by genre and region
Risk: read
Pass
next_page_number as page for pagination. sort accepts recent_added_first, oldest_added_first, recent_published_first, oldest_published_first, and listen_score.
Output
podcasts full type
podcasts full type
getByDomain
podcasts.getByDomain
Fetch podcasts published by a domain, with page pagination
Risk: read
Returns up to 10 podcasts per page. Pass
next_page_number as page to continue.
Output
podcasts full type
podcasts full type
getEpisodes
podcasts.getEpisodes
Fetch paginated episodes for a podcast by ID
Risk: read
This convenience operation uses the documented
GET /podcasts/{id} route and its next_episode_pub_date cursor; it is not a separate /episodes sub-route.
Output
episodes full type
episodes full type
getRecommendations
podcasts.getRecommendations
Fetch recommended podcasts based on a given podcast ID
Risk: read
Output
recommendations full type
recommendations full type
refreshRss
podcasts.refreshRss
Request an RSS refresh for a podcast (limited to hourly)
Risk: write
Available on PRO and ENTERPRISE plans; each podcast can be refreshed at most once per hour and processing may take several minutes.
Output
submit
podcasts.submit
Submit an RSS feed for review in the Listen Notes directory
Risk: write
Submissions may be found, reviewed, or rejected by Listen Notes. An email is optional and is used only for the provider’s acceptance notification.
Output
podcast full type
podcast full type
Regions
list
regions.list
Fetch supported country and region codes
Risk: read
Search
relatedSearches
search.relatedSearches
Find search terms related to a supplied topic
Risk: read
This endpoint is available only on Listen Notes PRO and ENTERPRISE plans.
Output
search
search.search
Full-text search for podcast episodes, channels, or curated lists
Risk: read
Pass
next_offset from a response as offset for pagination. Search results are limited by plan: FREE up to offset 30, PRO up to 300, and ENTERPRISE up to 10,000. interviews_only and sponsored_only are PRO/ENTERPRISE filters.
Output
searchEpisodeTitles
search.searchEpisodeTitles
Search for episodes by title with optional podcast filtering
Risk: read
The response may contain
next_offset, but the official OpenAPI request parameter list for this operation includes only q, podcast_id, and podcast_id_type; it does not document offset. The field is returned as provider metadata, not as a supported pagination cursor. Source: https://listen-api.listennotes.com/api/v2/openapi.json#/paths/~1search_episode_titles/get.
Output
spellcheck
search.spellcheck
Suggest spelling corrections for a search term
Risk: read
This endpoint is available only on Listen Notes PRO and ENTERPRISE plans.
Output
tokens full type
tokens full type
trendingSearches
search.trendingSearches
Fetch the latest trending search terms
Risk: read
typeahead
search.typeahead
Typeahead search for podcast titles, genres, and terms
Risk: read
Output
genres full type
genres full type
podcasts full type
podcasts full type