{
  "info": {
    "name": "Listen Notes — mcp.ai",
    "description": "REST API for the Listen Notes MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/listennotes",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "listennotes_batch_fetch_basic_meta_data_for_episodes",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/batch/fetch/basic/meta/data/for/episodes",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "batch",
            "fetch",
            "basic",
            "meta",
            "data",
            "for",
            "episodes"
          ]
        },
        "description": "The listennotestest_episodes_post endpoint allows users to retrieve metadata for multiple podcast episodes in a single request. This POST endpoint accepts a list of episode IDs and returns detailed in",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listennotes_batch_fetch_basic_meta_data_for_podcasts",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/batch/fetch/basic/meta/data/for/podcasts",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "batch",
            "fetch",
            "basic",
            "meta",
            "data",
            "for",
            "podcasts"
          ]
        },
        "description": "The listennotestest_podcasts_post endpoint allows users to retrieve information about multiple podcasts using various identifiers such as Listen Notes IDs, RSS feed URLs, Apple Podcasts IDs, or Spotif",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"ids\": \"\",\n  \"rsses\": \"\",\n  \"itunes_ids\": \"\",\n  \"spotify_ids\": \"\",\n  \"show_latest_episodes\": 0,\n  \"next_episode_pub_date\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listennotes_fetch_a_curated_list_of_podcasts_by_id",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/fetch/a/curated/list/of/podcasts/by/id",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "fetch",
            "a",
            "curated",
            "list",
            "of",
            "podcasts",
            "by",
            "id"
          ]
        },
        "description": "Retrieves detailed information about a specific curated podcast using its unique identifier. This endpoint allows users to access comprehensive data about a carefully selected podcast collection, incl",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listennotes_fetch_a_list_of_best_podcasts_by_genre",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/fetch/a/list/of/best/podcasts/by/genre",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "fetch",
            "a",
            "list",
            "of",
            "best",
            "podcasts",
            "by",
            "genre"
          ]
        },
        "description": "The getBestPodcasts endpoint retrieves a curated list of the best podcasts from the Listen Notes platform. It allows users to access a collection of top-rated or popular podcasts, which can be filtere",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"sort\": \"\",\n  \"region\": \"\",\n  \"genre_id\": \"\",\n  \"language\": \"\",\n  \"safe_mode\": 0,\n  \"publisher_region\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listennotes_fetch_a_list_of_podcast_genres",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/fetch/a/list/of/podcast/genres",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "fetch",
            "a",
            "list",
            "of",
            "podcast",
            "genres"
          ]
        },
        "description": "The GetGenres endpoint retrieves a comprehensive list of available genres within the listennotestest platform. This endpoint is designed to provide users with up-to-date information on content categor",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"top_level_only\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listennotes_fetch_a_list_of_your_playlists",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/fetch/a/list/of/your/playlists",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "fetch",
            "a",
            "list",
            "of",
            "your",
            "playlists"
          ]
        },
        "description": "Retrieves a list of playlists from the Listen Notes platform. This endpoint allows users to fetch all available playlists associated with their account or publicly accessible playlists. It should be u",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"sort\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listennotes_fetch_a_random_podcast_episode",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/fetch/a/random/podcast/episode",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "fetch",
            "a",
            "random",
            "podcast",
            "episode"
          ]
        },
        "description": "The 'just_listen' endpoint is a basic listener or health check mechanism for the listennotestest app. It allows users to verify the availability and responsiveness of the service without requiring any",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listennotes_fetch_audience_demographics_for_a_podcast",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/fetch/audience/demographics/for/a/podcast",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "fetch",
            "audience",
            "demographics",
            "for",
            "a",
            "podcast"
          ]
        },
        "description": "Retrieves audience information for a specific podcast identified by its unique ID. This endpoint allows users to access demographic data, listening statistics, or other audience-related metrics for a ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listennotes_fetch_curated_lists_of_podcasts",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/fetch/curated/lists/of/podcasts",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "fetch",
            "curated",
            "lists",
            "of",
            "podcasts"
          ]
        },
        "description": "Retrieves a list of curated podcasts from the Listen Notes platform. This endpoint provides access to a collection of handpicked and organized podcasts, likely curated by experts or algorithms. It's u",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listennotes_fetch_detailed_meta_data_for_an_episode_by_id",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/fetch/detailed/meta/data/for/an/episode/by/id",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "fetch",
            "detailed",
            "meta",
            "data",
            "for",
            "an",
            "episode",
            "by",
            "id"
          ]
        },
        "description": "Retrieves detailed information about a specific episode using its unique identifier. This endpoint allows users to access comprehensive data about an individual episode, which may include metadata suc",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"show_transcript\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listennotes_fetch_podcast_episodes_by_id",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/fetch/podcast/episodes/by/id",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "fetch",
            "podcast",
            "episodes",
            "by",
            "id"
          ]
        },
        "description": "Retrieves detailed information about a specific podcast using its unique identifier. This endpoint allows users to fetch comprehensive data about a particular podcast, including but not limited to its",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"sort\": \"\",\n  \"next_episode_pub_date\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listennotes_fetch_podcast_languages",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/fetch/podcast/languages",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "fetch",
            "podcast",
            "languages"
          ]
        },
        "description": "Retrieves a list of supported languages in the Listen Notes API. This endpoint provides information about the languages available for use within the platform, which can be crucial for internationaliza",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listennotes_fetch_podcasts_by_a_publisher_s_domain_name",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/fetch/podcasts/by/a/publisher/s/domain/name",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "fetch",
            "podcasts",
            "by",
            "a",
            "publisher",
            "s",
            "domain",
            "name"
          ]
        },
        "description": "Retrieves a list of podcasts associated with a specified domain name. This endpoint allows users to discover podcasts that are produced or hosted by a particular website or organization. It's useful f",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"domain_name\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listennotes_fetch_recommendations_for_a_podcast",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/fetch/recommendations/for/a/podcast",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "fetch",
            "recommendations",
            "for",
            "a",
            "podcast"
          ]
        },
        "description": "Retrieves a list of podcast recommendations based on a specified podcast ID. This endpoint is designed to help users discover new podcasts that are similar or related to a podcast they already enjoy. ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"safe_mode\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listennotes_fetch_recommendations_for_an_episode",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/fetch/recommendations/for/an/episode",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "fetch",
            "recommendations",
            "for",
            "an",
            "episode"
          ]
        },
        "description": "Retrieves a list of recommended podcast episodes based on a specific episode ID. This endpoint utilizes the Listen Notes API to generate personalized content suggestions, helping users discover new ep",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"safe_mode\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listennotes_fetch_related_search_terms",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/fetch/related/search/terms",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "fetch",
            "related",
            "search",
            "terms"
          ]
        },
        "description": "Retrieves a list of related search queries based on the current context or user's recent search activity. This endpoint is useful for enhancing user experience by suggesting alternative or complementa",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"q\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listennotes_fetch_supported_regions",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/fetch/supported/regions",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "fetch",
            "supported",
            "regions"
          ]
        },
        "description": "Retrieves information about available regions in the listennotestest platform. This endpoint allows users to fetch a list of regions, which can be used for filtering content, setting up notifications,",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listennotes_fetch_trending_search_terms",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/fetch/trending/search/terms",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "fetch",
            "trending",
            "search",
            "terms"
          ]
        },
        "description": "Retrieves a list of currently trending search terms related to podcasts. This endpoint provides real-time insights into popular topics and interests among podcast listeners. It's particularly useful f",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listennotes_find_episodes_by_title",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/find/episodes/by/title",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "find",
            "episodes",
            "by",
            "title"
          ]
        },
        "description": "The search_episode_titles endpoint allows users to search for and retrieve episode titles based on specified criteria. It provides a powerful way to find relevant episodes quickly, supporting real-tim",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"q\": \"\",\n  \"podcast_id\": \"\",\n  \"podcast_id_type\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listennotes_full_text_search",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/full/text/search",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "full",
            "text",
            "search"
          ]
        },
        "description": "The search endpoint allows users to query notifications or events within the listennotestest platform. It provides a way to find specific notifications based on keywords or identifiers, helping users ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"q\": \"\",\n  \"ncid\": \"\",\n  \"ocid\": \"\",\n  \"type\": \"\",\n  \"offset\": 0,\n  \"region\": \"\",\n  \"len_max\": 0,\n  \"len_min\": 0,\n  \"only_in\": \"\",\n  \"language\": \"\",\n  \"genre_ids\": \"\",\n  \"page_size\": 0,\n  \"safe_mode\": 0,\n  \"sort_by_date\": 0,\n  \"sponsored_only\": 0,\n  \"interviews_only\": 0,\n  \"published_after\": 0,\n  \"unique_podcasts\": 0,\n  \"update_freq_max\": 0,\n  \"update_freq_min\": 0,\n  \"published_before\": 0,\n  \"episode_count_max\": 0,\n  \"episode_count_min\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listennotes_get_playlist_by_id",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/playlist/by/id",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "playlist",
            "by",
            "id"
          ]
        },
        "description": "Retrieves detailed information about a specific playlist using its unique identifier. This endpoint allows users to fetch comprehensive data about a playlist, including its name, description, creator,",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"sort\": \"\",\n  \"type\": \"\",\n  \"last_timestamp_ms\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listennotes_refresh_rss_feed_of_a_podcast",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/refresh/rss/feed/of/a/podcast",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "refresh",
            "rss",
            "feed",
            "of",
            "a",
            "podcast"
          ]
        },
        "description": "Retrieves or generates an RSS feed for a specific podcast identified by its unique ID. This endpoint allows users to access the podcast's content in a standardized RSS format, which can be used for sy",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listennotes_request_to_delete_a_podcast",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/request/to/delete/a/podcast",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "request",
            "to",
            "delete",
            "a",
            "podcast"
          ]
        },
        "description": "Deletes a specific podcast from the system based on its unique identifier. This endpoint should be used when you want to permanently remove a podcast and all its associated data from the platform. It'",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"reason\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listennotes_spell_check_on_a_search_term",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/spell/check/on/a/search/term",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "spell",
            "check",
            "on",
            "a",
            "search",
            "term"
          ]
        },
        "description": "The spellcheck endpoint provides a spell-checking service for text input. It allows users to verify the spelling of words or phrases, likely related to audio content or podcast descriptions within the",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"q\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listennotes_submit_a_podcast_to_listen_notes_database",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/submit/a/podcast/to/listen/notes/database",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "submit",
            "a",
            "podcast",
            "to",
            "listen",
            "notes",
            "database"
          ]
        },
        "description": "The submit_podcast endpoint allows users to submit a podcast for inclusion in the Listen Notes database. This tool should be used when a user wants to add a new podcast to the Listen Notes platform or",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"rss\": \"\",\n  \"email\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "listennotes_typeahead_search",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/typeahead/search",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "typeahead",
            "search"
          ]
        },
        "description": "The typeahead endpoint provides real-time search suggestions as users type their queries. It's designed to enhance the user experience by offering relevant autocomplete options, making it easier for u",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"q\": \"\",\n  \"safe_mode\": 0,\n  \"show_genres\": 0,\n  \"show_podcasts\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}