Skip to main content
New to Corsair? See API access, authentication, and error handling.

Curated

get

curated.get Fetch a curated list of podcasts by ID Risk: read
Input Output

list

curated.list Fetch curated lists of podcasts Risk: read
Input Output

Episodes

get

episodes.get Fetch detailed metadata for an episode by ID Risk: read
Input show_transcript: 1 requests a transcript when available; transcript data requires a PRO or ENTERPRISE plan. Output

getBatch

episodes.getBatch Fetch basic metadata for up to 10 episodes Risk: read
Input Supports up to 10 episode IDs and is available only on PRO and ENTERPRISE plans. Output

getRecommendations

episodes.getRecommendations Fetch recommended episodes based on a given episode ID Risk: read
Input Output

justListen

episodes.justListen Fetch a random recently published podcast episode Risk: read
Input: empty object Output

Genres

list

genres.list Fetch a list of podcast genres supported by Listen Notes Risk: read
Input Output

Languages

list

languages.list Fetch languages supported by the Listen Notes directory Risk: read
Input: empty object Output

Playlists

addItem

playlists.addItem Add an episode or podcast to a playlist Risk: write
Input 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
Input 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
Input 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
Input 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
Input A playlist can hold both episodes and podcasts. Use type to choose the view and last_timestamp_ms from the response to paginate. Output

list

playlists.list Fetch a list of user playlists Risk: read
Input sort supports name_a_to_z and name_z_to_a; page paginates through playlists. Output

update

playlists.update Update playlist metadata or its saved default view Risk: write
Input 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
Input 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
Input 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
Input 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

getAudience

podcasts.getAudience Fetch available audience region demographics for a podcast Risk: read
Input Audience estimates are available only for some podcasts; an empty response is valid when the provider has no regional data. Output

getBatch

podcasts.getBatch Fetch basic metadata for up to 10 podcasts by supported IDs Risk: read
Input 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

getBest

podcasts.getBest Fetch best podcasts by genre and region Risk: read
Input 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

getByDomain

podcasts.getByDomain Fetch podcasts published by a domain, with page pagination Risk: read
Input Returns up to 10 podcasts per page. Pass next_page_number as page to continue. Output

getEpisodes

podcasts.getEpisodes Fetch paginated episodes for a podcast by ID Risk: read
Input 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

getRecommendations

podcasts.getRecommendations Fetch recommended podcasts based on a given podcast ID Risk: read
Input Output

refreshRss

podcasts.refreshRss Request an RSS refresh for a podcast (limited to hourly) Risk: write
Input 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
Input 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

Regions

list

regions.list Fetch supported country and region codes Risk: read
Input: empty object Output

relatedSearches

search.relatedSearches Find search terms related to a supplied topic Risk: read
Input 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
Input 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
Input 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
Input This endpoint is available only on Listen Notes PRO and ENTERPRISE plans. Output

trendingSearches

search.trendingSearches Fetch the latest trending search terms Risk: read
Input: empty object Output

typeahead

search.typeahead Typeahead search for podcast titles, genres, and terms Risk: read
Input Output