Skip to content
Changelog

Report a bug

Listen Notes integration: operations for AI agents

Listen Notes connects to Type.com as an integration. This page lists the 32 operations documented for Claude and Codex in Type.com: 21 read, 6 write, 5 destructive.

About Listen Notes

Listen Notes is a powerful podcast search engine and database that allows you to discover, explore, and listen to millions of podcasts and episodes worldwide.

Categories: Design & Media

How to connect Listen Notes to Type.com

Access
Organization connection: one shared account for the workspace.

To add the connection, follow the steps in Space connections.

Documented operations

32 operations. Your connection's permissions determine which operations are available. API references describe the vendor surface; they do not expand your connection's credentials or access.

32 operations listed.

Search API

  • Read

    Typeahead search

    Suggest search terms, podcast genres, and podcasts.

  • Read

    Find individual episodes by searching for their titles

    Conduct targeted searches for individual episodes by title and refine results using the podcast id such as Listen Notes Podcast ID, Apple Podcasts ID, Spotify ID, or RSS feed URL.

  • Read

    Fetch trending search terms

    Fetch up to 10 most recent trending search terms on the Listen Notes platform.

  • Read

    Fetch related search terms

    Suggest related search terms. The results are more comprehensive than from GET /typeahead. This endpoint is available only in the PRO/ENTERPRISE plan.

  • Read

    Spell check on a search term

    Suggest a list of words that correct the spelling errors of a search term. This endpoint is available only in the PRO/ENTERPRISE plan.

Directory API

  • Read

    Fetch a list of best podcasts by genre

    Get a list of curated best podcasts by genre, which are curated by Listen Notes staffs based on various signals from the Internet, e.g., top charts on other podcast platforms, recommendations from mainstream media, user activities on listennotes.com...

  • Read

    Fetch detailed meta data and episodes for a podcast by id

    Fetch detailed meta data and episodes for a specific podcast (up to 10 episodes each time). You can use the nextepisodepubdate parameter to do pagination and fetch more episodes.

  • Read

    Fetch detailed meta data for an episode by id

    Fetch detailed meta data for a specific episode.

  • Read

    Fetch a curated list of podcasts by id

    Get detailed meta data of all podcasts in a specific curated list. This endpoint returns same data as https://www.listennotes.com/curated-podcasts/

  • Read

    Fetch a list of podcast genres

    Get a list of podcast genres that are supported in Listen Notes. The genre id can be passed to other endpoints as a parameter to get podcasts in a specific genre, e.g., GET /bestpodcasts, GET /search... You may want to cache the list of genres on the client side.

  • Read

    Fetch a list of supported countries/regions for best podcasts

    It returns a dictionary of country codes (e.g., us, gb...) & country names (United States, United Kingdom...). The country code is used in the query parameter region of GET /bestpodcasts.

  • Read

    Fetch a list of supported languages for podcasts

    Get a list of languages that are supported in Listen Notes database. You can use the language string as query parameter in GET /search.

  • Read

    Fetch a random podcast episode

    Recently published episodes are more likely to be fetched. Good luck!

  • Read

    Fetch curated lists of podcasts

    A bunch of curated lists from online media. For each list, you'll get basic info of up to 5 podcasts. To get detailed meta data of all podcasts in a specific list, you need to use GET /curatedpodcasts/{id}. We add new curated lists to the database on a daily basis.

  • Read

    Fetch recommendations for a podcast

    Fetch up to 8 podcast recommendations based on the given podcast id.

  • Read

    Fetch recommendations for an episode

    Fetch up to 8 episode recommendations based on the given episode id.

  • Write

    Batch fetch basic meta data for episodes

    Batch fetch basic meta data for up to 10 episodes. This endpoint could be used to implement custom playlists for individual episodes. For detailed meta data of an individual episode, you need to use GET /episodes/{id}. This endpoint is available only in the PRO/ENTERPRISE plan.

  • Write

    Batch fetch basic meta data for podcasts

    Batch fetch basic meta data for up to 10 podcasts. This endpoint could be used to build something like OPML import, allowing users to import a bunch of podcasts via rss urls. For detailed meta data (including episodes) of an individual podcast, you need to use GET /podcasts/{id}.

Podcaster API

  • Write

    Submit a podcast to Listen Notes database

    Podcast hosting services can use this endpoint to help your users directly submit a new podcast to Listen Notes database. If the podcast doesn't exist in the database, "status" in the response will be "in review", and we'll review it within 12 hours.

  • Write

    Refresh RSS feed of a podcast

    Refresh a podcast's RSS feed. Each podcast is limited to one refresh per hour. Refresh durations range from a few seconds to several minutes, contingent on the RSS feed size and server responsiveness. This endpoint is available only in the PRO/ENTERPRISE plan.

  • Destructive

    Request to delete a podcast

    Podcast hosting services can use this endpoint to streamline the process of podcast deletion on behave of their users (podcasters). We will review the deletion request within 12 hours. If the podcast is already deleted, the "status" field in the response will be "deleted".

Playlist API

  • Read

    Fetch a playlist's info and items (i.e., episodes or podcasts).

    A playlist can contain both episodes and podcasts, shown in separate views, just like playlists created via listennotes.com/listen/. This endpoint fetches items from the saved default view unless type is specified. The response type and listennotesurl describe the selected view.

  • Read

    Fetch a list of your playlists.

    This endpoint lists playlists with an active membership for the API admin, including playlists they created or joined. Each playlist includes its saved default type and a listennotesurl for that view. You can use the page parameter to do pagination and fetch more playlists.

  • Write

    Create a playlist.

    Create an empty playlist owned by the API admin. Name is required; description defaults to an empty string, visibility defaults to public, and type defaults to episodelist. Set type to podcastlist to make podcasts the default view.

  • Write

    Add an episode or podcast to a playlist.

    Provide exactly one non-empty episodeid or podcastid; an empty unused ID field is ignored. Invalid ID formats return 400 and identify the field. A missing episode or podcast returns 404 with an error such as "Episode not found: {episodeid}." or "Podcast not found: {podcastid}.".

  • Destructive

    Update playlist metadata.

    Update any subset of name, description, visibility, and type. Omitted fields remain unchanged; at least one field is required. Switching to private rotates the playlist RSS secret.

  • Destructive

    Delete a playlist.

    Permanently delete a playlist, including all episode and podcast references saved in this specific playlist and their notes. The actual episodes and podcasts remain in the Listen Notes podcast database. Warning: Deletion cannot be undone.

  • Destructive

    Update notes for a playlist item.

    Replace item notes, or send an empty string to clear them. The item ID and addedatms remain unchanged. Only playlists owned by your admin API account can be modified; contributor membership does not grant write access.

  • Destructive

    Remove an item from a playlist.

    Delete a playlist item. Repeating deletion of the same item succeeds. This does not delete the episode or podcast from the podcast database. Only playlists owned by your admin API account can be modified; contributor membership does not grant write access.

Insights API

  • Read

    Fetch audience demographics for a podcast

    Fetch audience demographics for a podcast - 1) directly measured on the Listen Notes platform; 2) only supports audience breakdown by regions for now; 3) not every podcast has data.

  • Read

    Fetch podcasts by a publisher's domain name

    Fetch podcasts by a publisher's domain name, e.g., nytimes.com, wondery.com, npr.org... Each request will return up to 10 podcasts. You can use the page parameter to paginate.

See How connections work for access and permissions, or browse all integrations.