Listennotes
Overview
SLUG: LISTENNOTES
Description
The best podcast search engine.
Authentication Details
API Key
Connecting to Listennotes
Create an auth config
Use the dashboard to create an auth config for the Listennotes toolkit. This allows you to connect multiple Listennotes accounts to Composio for agents to use.
Create and Get auth config ID
Click “Create Integration”. After creation, copy the displayed ID starting with ac_
. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database.
This ID will be used to create connections to the toolkit for a given user.
Connect Your Account
Using API Key
Tools
Executing tools
To prototype you can execute some tools to see the responses and working on the Listennotes toolkit’s playground
OpenAI (Python)
Anthropic (TypeScript)
Google (Python)
Vercel (TypeScript)
Tool List
LISTENNOTES_FETCH_A_LIST_OF_YOUR_PLAYLISTS
Tool Name: Get playlists
Description
Action Parameters
Action Response
LISTENNOTES_FETCH_A_RANDOM_PODCAST_EPISODE
Tool Name: Listen to just listen endpoint
Description
Action Parameters
Action Response
LISTENNOTES_FULL_TEXT_SEARCH
Tool Name: Search operation endpoint
Description
Action Parameters
Action Response
LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_EPISODES
Tool Name: Post episodes by ids
Description
Action Parameters
Action Response
LISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_PODCASTS
Tool Name: Create podcast via form data
Description
Action Parameters
Action Response
LISTENNOTES_FETCH_AUDIENCE_DEMOGRAPHICS_FOR_A_PODCAST
Tool Name: Get podcast audience by id
Description
Action Parameters
Action Response
LISTENNOTES_FETCH_A_CURATED_LIST_OF_PODCASTS_BY_ID
Tool Name: Retrieve curated podcast by id
Description
Action Parameters
Action Response
LISTENNOTES_FETCH_A_LIST_OF_BEST_PODCASTS_BY_GENRE
Tool Name: Fetch best podcasts list
Description
Action Parameters
Action Response
LISTENNOTES_FETCH_A_LIST_OF_PODCAST_GENRES
Tool Name: Retrieve genre list
Description
Action Parameters
Action Response
LISTENNOTES_FETCH_CURATED_LISTS_OF_PODCASTS
Tool Name: Get curated podcasts
Description
Action Parameters
Action Response
LISTENNOTES_FETCH_DETAILED_META_DATA_FOR_AN_EPISODE_BY_ID
Tool Name: Retrieve episode by id
Description
Action Parameters
Action Response
LISTENNOTES_FETCH_PLAYLIST_INFO
Tool Name: Fetch Playlist Info
Description
Action Parameters
Action Response
LISTENNOTES_FETCH_PODCASTS_BY_A_PUBLISHER_S_DOMAIN_NAME
Tool Name: Get podcast domains by name
Description
Action Parameters
Action Response
LISTENNOTES_FETCH_PODCAST_DETAILS_AND_EPISODES
Tool Name: Fetch Podcast Details And Episodes
Description
Action Parameters
Action Response
LISTENNOTES_FETCH_PODCAST_LANGUAGES
Tool Name: Fetch podcast languages
Description
Action Parameters
Action Response
LISTENNOTES_FETCH_RECOMMENDATIONS_FOR_AN_EPISODE
Tool Name: Get episode recommendations by id
Description
Action Parameters
Action Response
LISTENNOTES_FETCH_RECOMMENDATIONS_FOR_A_PODCAST
Tool Name: Get podcast recommendations by id
Description
Action Parameters
Action Response
LISTENNOTES_FETCH_SUPPORTED_REGIONS
Tool Name: Fetch Supported Regions
Description
Action Parameters
Action Response
LISTENNOTES_FETCH_TRENDING_SEARCH_TERMS
Tool Name: Retrieve trending searches
Description
Action Parameters
Action Response
LISTENNOTES_REFRESH_RSS_FEED_OF_A_PODCAST
Tool Name: Post podcast rss by id
Description
Action Parameters
Action Response
LISTENNOTES_REQUEST_TO_DELETE_A_PODCAST
Tool Name: Delete podcast by id
Description
Action Parameters
Action Response
LISTENNOTES_SEARCH_EPISODE_TITLES
Tool Name: Search Episode Titles
Description
Action Parameters
Action Response
LISTENNOTES_SPELL_CHECK_ON_A_SEARCH_TERM
Tool Name: Spell check retrieval
Description
Action Parameters
Action Response
LISTENNOTES_SUBMIT_A_PODCAST_TO_LISTEN_NOTES_DATABASE
Tool Name: Submit podcast rss url
Description
Action Parameters
Action Response
LISTENNOTES_TYPEAHEAD_SEARCH
Tool Name: Get typeahead suggestions
Description
Action Parameters
Action Response