SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

Listennotes API

Give your agents access to Listennotes API. Bring your own Listennotes key, or skip the signup and pay per call from your Composio balance with Composio Instant.

Get started for freeGet a demo
Listennotes logoListennotes
Instant

Listennotes is a powerful podcast search engine with a massive global database. Discover, search, and curate podcasts from around the world in seconds.

26 Tools
COMPOSIO INSTANT

What is Composio Instant?

Composio Instant lets your agent use paid APIs like Listennotes without a separate account or API key for each one. New accounts start with $2 of free credit.

No Listennotes account or key

Your agent calls Listennotes through Composio, so there is nothing to sign up for, store, or rotate.

Pay per call, at cost

$0.04 per successful API request, paid from your Composio balance with zero markup.

Works in any agent

Claude, ChatGPT, Cursor, and other MCP clients, or your own code with the Composio SDK.

Works with your apps

Use Listennotes with Gmail, Slack, Google Sheets, and 1,700+ other apps you connect.

AI ASSISTANTS

Connect the Listennotes API to your AI assistant

Use Listennotes from the AI assistant you already work in. Connect Composio once, then paste the prompt.

  1. 1

    Open the Connectors menu

    Use the button to open Claude's Add connector dialog with Composio filled in. Or click + in the message box, then Connectors, Add connector and Add custom connector.
    Add Composio to Claude
  2. 2

    Add the Composio MCP server

    Name it Composio, paste the MCP server URL and click Add.
    https://connect.composio.dev/mcp
  3. 3

    Authorize in your browser

    A browser window opens. Sign in to Composio to approve the connection.
  4. 4

    Paste the prompt

    Start a new chat and paste the prompt. Claude runs the call on Composio Instant.
  1. 1

    Install the Composio plugin

    Open Composio's plugin page in ChatGPT and click Install. Sign in to ChatGPT first if it asks.
    Install in ChatGPT
  2. 2

    Authorize in your browser

    Connect the plugin, then sign in to Composio to approve the connection.
  3. 3

    Turn on Composio in your chat

    In a new chat, click +, then More, and select Composio.
  4. 4

    Paste the prompt

    Paste the prompt into that chat. ChatGPT runs the call on Composio Instant.
  1. 1

    Install the Composio plugin

    Open Composio in the Cursor marketplace, click Install Composio Plugin for Cursor and approve the connection in your browser.
    Install in Cursor
  2. 2

    Paste the prompt

    Open the Agent chat and paste the prompt. Cursor runs the call on Composio Instant.
  1. 1

    Add the Composio plugin

    Open Composio's listing on x.ai and click Add to Grok Bot. When Grok Bot opens the plugin, click Add.
    Add to Grok Bot
  2. 2

    Authenticate

    Go to Installed, open Composio and click Authenticate. Sign in to Composio and click Authorize.
  3. 3

    Paste the prompt

    Paste the prompt into your bot's chat. Grok Bot runs the call on Composio Instant.
  1. 1

    Paste the setup prompt

    Copy this into your Hermes chat. Hermes adds the Composio MCP server for you.
    Set up Composio from composio.dev/hermes
  2. 2

    Authorize in your browser

    A browser window opens. Sign in to Composio to approve the connection.
  3. 3

    Paste the prompt

    Start a new chat and paste the prompt. Hermes runs the call on Composio Instant.
ClaudeNew chat

Paste this prompt

Use Listen Notes through Composio Instant to search for three podcast episodes about artificial intelligence. Return the episode titles and podcast names.

What success looks like

LISTENNOTES_FULL_TEXT_SEARCH

Your assistant runs Listen Notes and replies with up to three episode titles and podcast names about artificial intelligence.

Runs on Composio Instant
SDK

Use the Listennotes API in your code

Call Listennotes from your own agent with the Composio SDK. Four steps and one tool call.

  1. 1

    Set up Composio

    Turn on Instant Toolkits in your project settings and check your prepaid balance in Billing. Then set your API key.
    export COMPOSIO_API_KEY="your_composio_api_key"
  2. 2

    Install the SDK

    The Python SDK needs Python 3.11 through 3.15.
    pip install composio
  3. 3

    Run the call

    Create a session that keeps Instant to this toolkit and reports the charge, then run the tool on the Instant account.
    LISTENNOTES_FULL_TEXT_SEARCH
  4. 4

    Read the response

    When the call runs on Instant, the response includes its charge: the amount as an exact USD decimal string, the currency and charged_by.
agent.py
from composio import Composio

composio = Composio()

session = composio.sessions.create(
    user_id="user_123",
    toolkits=["listennotes"],
    instant={
        "toolkits": {"enable": ["listennotes"]},
        "return_instant_charge": True,
    },
)

result = session.execute(
    "LISTENNOTES_FULL_TEXT_SEARCH",
    arguments={
        "q": "artificial intelligence",
        "type": "episode",
        "page_size": 3,
    },
    account="instant_account",
)
print(result)
print("Instant charge:", result.instant_charge)
TOOLS

Available Listennotes API tools

21 Listennotes tools run on Instant, priced per call with no Listennotes key.

ActionTool slugWhat it doesAvailability
Search PodcastsLISTENNOTES_FULL_TEXT_SEARCHSearch for episodes, podcasts, or curated lists with a text query.
Instant$0.04 per successful API request
Get Podcast EpisodesLISTENNOTES_FETCH_PODCAST_EPISODES_BY_IDRetrieve podcast details and a page of its episodes.
Instant$0.04 per successful API request
Get Episode DetailsLISTENNOTES_FETCH_DETAILED_META_DATA_FOR_AN_EPISODE_BY_IDRetrieve detailed information about an episode by ID.
Instant$0.04 per successful API request
Get Audience DataLISTENNOTES_FETCH_AUDIENCE_DEMOGRAPHICS_FOR_A_PODCASTRetrieve audience demographics for a podcast by ID.
Instant$0.04 per successful API request
Find RecommendationsLISTENNOTES_FETCH_RECOMMENDATIONS_FOR_A_PODCASTFind podcast recommendations based on a podcast ID.
Instant$0.04 per successful API request
Fetch Best PodcastsLISTENNOTES_FETCH_A_LIST_OF_BEST_PODCASTS_BY_GENRERetrieve a curated list of top podcasts.
Instant$0.04 per successful API request
Create podcast via form dataLISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_PODCASTSRetrieves metadata for multiple podcasts by Listen Notes IDs, RSS URLs, Apple Podcasts IDs, or Spotify IDs, with optional latest episodes.
Instant$0.04 per successful API request
Fetch podcast languagesLISTENNOTES_FETCH_PODCAST_LANGUAGESRetrieves the list of supported podcast languages from Listen Notes for use in content filtering.
Instant$0.04 per successful API request
Fetch related searches dataLISTENNOTES_FETCH_RELATED_SEARCH_TERMSRetrieves search terms related to a supplied search query.
Instant$0.04 per successful API request
Fetch Supported RegionsLISTENNOTES_FETCH_SUPPORTED_REGIONSRetrieves information about available regions in the listennotestest platform.
Instant$0.04 per successful API request
Get curated podcastsLISTENNOTES_FETCH_CURATED_LISTS_OF_PODCASTSRetrieves a page of curated podcast lists from Listen Notes, with list metadata and a preview of up to five podcasts in each list.
Instant$0.04 per successful API request
Get episode recommendations by idLISTENNOTES_FETCH_RECOMMENDATIONS_FOR_AN_EPISODERetrieves a list of recommended podcast episodes based on a specific episode ID.
Instant$0.04 per successful API request
Get podcast domains by nameLISTENNOTES_FETCH_PODCASTS_BY_A_PUBLISHER_S_DOMAIN_NAMERetrieves a list of podcasts associated with a specified domain name.
Instant$0.04 per successful API request
Get typeahead suggestionsLISTENNOTES_TYPEAHEAD_SEARCHRetrieves typeahead search-term suggestions for a query, with optional podcast and genre suggestions.
Instant$0.04 per successful API request
Listen to just listen endpointLISTENNOTES_FETCH_A_RANDOM_PODCAST_EPISODERetrieves a random podcast episode from Listen Notes, with episode metadata and associated podcast information.
Instant$0.04 per successful API request
Post episodes by idsLISTENNOTES_BATCH_FETCH_BASIC_META_DATA_FOR_EPISODESRetrieves metadata for multiple known podcast episodes by ID in one request.
Instant$0.04 per successful API request
Retrieve curated podcast by idLISTENNOTES_FETCH_A_CURATED_LIST_OF_PODCASTS_BY_IDRetrieves detailed information about a specific curated podcast using its unique identifier.
Instant$0.04 per successful API request
Retrieve genre listLISTENNOTES_FETCH_A_LIST_OF_PODCAST_GENRESThe GetGenres endpoint retrieves a comprehensive list of available genres within the listennotestest platform.
Instant$0.04 per successful API request
Retrieve trending searchesLISTENNOTES_FETCH_TRENDING_SEARCH_TERMSRetrieves a list of currently trending search terms related to podcasts.
Instant$0.04 per successful API request
Search Episode TitlesLISTENNOTES_FIND_EPISODES_BY_TITLESearches for podcast episodes by title, optionally restricted to a specified podcast.
Instant$0.04 per successful API request
Spell check retrievalLISTENNOTES_SPELL_CHECK_ON_A_SEARCH_TERMChecks the spelling of a supplied search term and returns misspelled tokens, suggestions, and corrected text with HTML formatting.
Instant$0.04 per successful API request

Instant prices are Listennotes's list prices with 0% markup, paid from your Composio balance and updated every hour. Instant calls also count toward your plan's tool calls. See all plans on the pricing page.

USE CASES

Listennotes API use cases and example prompts

Copy a prompt into your agent. Each one uses Listennotes with apps you connect through Composio.

  • Brief the team on podcast coverage

    Use Listen Notes to find podcast episodes and shows covering our product category. Pick the most relevant results and summarize their episode details in my Product Insights brief in Google Docs. Post the brief link and a three-point summary in Slack's #content channel.

    Apps used: Listennotes, Google Docs, Slack

  • Build a podcast PR shortlist

    Use Listen Notes to find podcasts that cover Acme's product category, then get audience data for the strongest matches. Add the show names, audience findings, and fit notes to my Podcast PR shortlist in Google Sheets. Draft a Gmail message to our PR team with the best picks and a pitch angle for each.

    Apps used: Listennotes, Google Sheets, Gmail

  • Find shows for a content partnership

    Use Listen Notes to find my Acme product podcast and get recommendations based on it. Save the recommended shows and audience findings in a Podcast Partnership Research page in Notion, with a note on which shows fit a content partnership.

    Apps used: Listennotes, Notion

  • Map a category's podcast landscape

    Use Listen Notes to get a curated list of top podcasts in our category, then retrieve episode lists for the strongest matches. Compare the episode topics and save a podcast landscape brief in my Marketing Research folder in Google Drive. Post the brief link in Slack's #marketing channel.

    Apps used: Listennotes, Google Drive, Slack

TROUBLESHOOTING

Listennotes API troubleshooting

Still stuck? The Instant tools docs cover limits, charges and session settings.

Start with Listennotes.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Listennotes tool your agent needs.Free to start.

Start building