Listen Notes

Listen Notes integration (Data). Imported from open-connector.

API key9 toolshttps://listen-api.listennotes.com/api/v2

GET

listennotes_search

Search Listen Notes podcasts or episodes by keyword.

/search

11 parameters

Param	Type	Required	Description
q	string	required	The search keywords to send to Listen Notes.
type	string	optional	The supported Listen Notes search result type.
offset	integer	optional	The search offset for pagination.
region	string	optional	The region code used to limit search results.
language	string	optional	The language label used to limit search results.
genreIds	array	optional	The Listen Notes genre identifiers used to filter results.
pageSize	integer	optional	The number of search results to return per page.
safeMode	boolean	optional	Whether to exclude explicit podcasts or episodes.
sortByDate	boolean	optional	Whether to sort search results by publication date instead of relevance.
onlyIn	array	optional	The specific upstream fields to search within.
uniquePodcasts	boolean	optional	Whether to keep only one episode per podcast for episode searches.

GET

listennotes_typeahead

Get Listen Notes typeahead suggestions for terms, genres, and podcasts.

/typeahead

4 parameters

Param	Type	Required	Description
q	string	required	The typeahead keywords to send to Listen Notes.
safeMode	boolean	optional	Whether to exclude explicit podcast suggestions.
showGenres	boolean	optional	Whether to include genre suggestions.
showPodcasts	boolean	optional	Whether to include podcast suggestions.

GET

listennotes_get_podcast

Get Listen Notes podcast details and one page of episodes by podcast ID.

/podcasts/{id}

3 parameters

Param	Type	Required	Description
id	string	required	The Listen Notes podcast identifier.
sort	string	optional	The episode sort order for podcast detail results.
nextEpisodePubDate	integer	optional	The episode pagination cursor returned by Listen Notes.

GET

listennotes_get_episode

Get Listen Notes episode details by episode ID.

/episodes/{id}

1 parameter

Param	Type	Required	Description
id	string	required	The Listen Notes episode identifier.

GET

listennotes_get_best_podcasts

Get ranked best podcasts from Listen Notes with optional directory filters.

/best_podcasts

7 parameters

Param	Type	Required	Description
page	integer	optional	The best podcasts page number to retrieve.
sort	string	optional	The ranking sort applied to best podcasts results.
region	string	optional	The region code used to rank best podcasts.
genreId	integer	optional	One Listen Notes genre identifier.
language	string	optional	The language label used to filter best podcasts.
safeMode	boolean	optional	Whether to exclude explicit podcasts.
publisherRegion	string	optional	The publisher region code used to filter best podcasts.

GET

listennotes_get_genres

Get the supported Listen Notes podcast genres.

/genres

1 parameter

Param	Type	Required	Description
topLevelOnly	boolean	optional	Whether to return only top-level genres.

GET

listennotes_get_regions

Get the supported Listen Notes regions used by best podcasts.

/regions

GET

listennotes_get_languages

Get the supported Listen Notes podcast languages.

/languages

GET

listennotes_get_related_podcasts

Get related podcast recommendations from Listen Notes by podcast ID.

/podcasts/{id}/recommendations

2 parameters

Param	Type	Required	Description
id	string	required	The Listen Notes podcast identifier.
safeMode	boolean	optional	Whether to exclude explicit recommendations.