# Podchaser API MCP > Podchaser Podcast API connects your AI agent directly to a global database of podcast metadata. Use it to search for thousands of shows by keyword, audit full episode lists, and retrieve deep data on hosts and ratings. It moves audio research from manual directory browsing into natural conversation. ## Overview - **Category:** audio-music - **Price:** Free - **Tags:** podcast-database, audio-metadata, podcast-discovery, host-research, episode-tracking, media-intelligence ## Description **Podchaser Podcast API** hooks your AI agent up right into a massive, live database of podcast metadata. You skip the whole headache of clicking through directory pages; you just talk to the data and get what you need. This server lets your agent run deep media audits by calling specific tools on demand. First off, before you start any research, it’s smart to **check_api_status**. Running this tool confirms if the Podchaser API is up and running and ready to accept requests—you don't wanna waste time sending queries to a dead endpoint. When you need to find new content, your agent runs `search_podcasts`. You just toss in keywords or titles, and it spits back a list of podcast IDs, full descriptions, and community ratings that match the term you gave it. Once you've found a promising show, you use `get_podcast_details` with its unique ID. This tool pulls every bit of metadata available for that specific show, including their official descriptions, dedicated unique identifiers, and all their social media links so you know where to find 'em online. Need the full history of a series? Running `list_podcast_episodes` requires just one thing: the podcast ID. This tool then gets you a complete, chronological record—every single episode published for that show's entire run. You see the whole timeline and all the details on each release. This setup means your agent can handle everything from initial discovery to deep archival research without needing manual intervention. It lets you audit full podcast lists by grabbing every episode associated with a given ID, pulling together the complete content history for an entire series at once. You're not just reading titles; your agent is getting structured data that includes descriptions and community ratings across thousands of shows. When you combine these tools, your AI client doesn't just search—it performs complex operations. It searches for podcasts by keyword using `search_podcasts`, then takes one of the resulting IDs to pull all available information on it with `get_podcast_details`. From there, you can run `list_podcast_episodes` to get a full episode list or you might just want to verify that your entire research pipeline is working by running `check_api_status`. You're moving audio research out of the manual directory browsing nightmare and right into a natural conversation with your agent. It’s direct, it’s fast, and every piece of data comes from this single source. ## Tools ### check_api_status Confirms if the Podchaser API is currently online and accepting requests. ### get_podcast_details Retrieves all metadata—including descriptions, unique IDs, and social links—for one specific podcast show ID. ### list_podcast_episodes Gets a complete record of every episode published for a single given podcast ID. ### search_podcasts Finds multiple podcasts across the platform using keywords or titles. ## Prompt Examples **Prompt:** ``` Search for podcasts about 'data science' using Podchaser. ``` **Response:** ``` I've retrieved several podcasts about data science! Notable entries include 'The Data Engineering Podcast' and 'Linear Digressions'. Would you like the full descriptions or the episode list for any of these shows? ``` **Prompt:** ``` What are the latest episodes for podcast ID '12345'? ``` **Response:** ``` I've identified the episodes for that podcast! Notable recent titles include [Title 1] and [Title 2], both released in the last week. I can provide the air dates and durations for each of these entries if you'd like. ``` **Prompt:** ``` Show details for podcast 'The Daily'. ``` **Response:** ``` I've retrieved the details for The Daily! It is currently identified as a 'News' podcast with a high rating. I can provide the unique ID and host metadata to help you identify it in your workflow. ``` ## Capabilities ### Search for podcasts by keyword Your agent runs `search_podcasts` and returns a list of podcast IDs, full descriptions, and community ratings matching the provided term. ### Retrieve metadata for a single show Using an ID, your agent executes `get_podcast_details` to get all available information on one specific show, including social media links. ### List every episode in a podcast series Your agent runs `list_podcast_episodes` with an ID and gets a complete chronological list of every published episode for that series. ### Verify API connection status The system executes `check_api_status`, confirming the server is currently running and ready to accept requests. ## Use Cases ### Tracking competitor coverage A marketing team needs to know how many times a specific topic was covered by industry podcasts last quarter. They start by using `search_podcasts` with the core topic keyword. Then, for the top 5 results, they use `list_podcast_episodes` on each one to count total episodes and track content volume over time. ### Building a knowledge base of niche topics A researcher needs metadata for all podcasts in the 'quantum physics' space. They run `search_podcasts` with 'quantum.' The agent then uses `get_podcast_details` on each result to pull out unique IDs and full descriptions, creating structured records for their database. ### Auditing a long-running series A journalist is writing about the history of a specific show. They input the podcast ID into `list_podcast_episodes`. This action immediately gives them all air dates and titles, letting them structure their article around the show's entire timeline. ### Verifying data integrity before publication An operations lead runs a quick `check_api_status` first. If the service is green, they know that when they run complex queries like searching for 'AI ethics,' their agent won't hit an outage and lose valuable research time. ## Benefits - **Full Episode History:** Stop guessing how old the content is. By running `list_podcast_episodes`, you get a complete, chronological list of every single piece of audio published for any given show ID. - **Deep Metadata Retrieval:** When you find a podcast via `search_podcasts`, use `get_podcast_details` to grab all the supplementary data—like unique IDs and social links—you need for your database. - **Targeted Discovery:** Don't waste time browsing. Use `search_podcasts` to narrow down thousands of shows instantly using a simple keyword or phrase. - **Reliability Check:** Before starting any big audit, run `check_api_status`. This quick check ensures your entire research workflow won't fail mid-task due to service degradation. - **Actionable Insight:** Your agent doesn't just list titles; it brings back community ratings and descriptions. You get the context needed to decide if a show is worth following. ## How It Works The bottom line is that your AI client handles the API calls. You just ask it what you want to know about podcasts, and it runs the necessary tools automatically. 1. First, subscribe to this server on Vinkius and input your unique Podchaser API Key. 2. Next, you prompt your AI client (e.g., Claude or Cursor) with a natural language query like: 'Find me all podcasts about space travel.' 3. Your agent identifies the need for `search_podcasts`, calls the tool, and presents the retrieved metadata list directly in the conversation. ## Frequently Asked Questions **How do I find a podcast by keyword using search_podcasts?** Just tell your agent to run `search_podcasts` and give it the keywords. The API returns multiple results, each with metadata like descriptions and ratings, so you can choose which ID you want to audit next. **What is the difference between search_podcasts and get_podcast_details?** `search_podcasts` finds multiple potential shows based on a broad query. `get_podcast_details`, however, requires you to already have a specific podcast ID before it can retrieve all the depth data for that single show. **Can I list episodes using just the title?** No. You must first use `search_podcasts` or `get_podcast_details` to get a unique podcast ID. Then, you pass that specific ID into `list_podcast_episodes`. **Do I need to check the API status before running an audit?** Yes. Always start by calling `check_api_status`. This confirms the server is live and ready, preventing your agent from failing mid-task due to a temporary connection issue. **What kind of metadata can I retrieve using get_podcast_details?** It returns comprehensive data, including unique IDs, full descriptions, social media links, and host information. You get everything you need to reference the podcast in a structured workflow. **If I run list_podcast_episodes with an incorrect ID, what error message should I expect?** The API will return a specific status code and error payload confirming that the provided podcast ID does not exist. You must verify the ID first before attempting to list episodes. **What are the typical usage limits or rate limits for search_podcasts?** The service enforces standard API rate limiting to ensure stability. If you run high-volume audits, monitor your requests per minute and plan batching accordingly. **How easy is it to parse and use the results generated by search_podcasts with my agent?** The data comes back in a structured, machine-readable format. Your AI client can easily process the list of titles, keywords, and metadata for immediate follow-up tasks. **How do I find my Podchaser API Key?** Log in to your [**Podchaser developer portal**](https://api.podchaser.com/), create an application, and you will find your API Token in your dashboard. Copy and paste it below. **Can I search for podcasts by host?** Yes. The search tools allow you to use host names as keywords to retrieve podcasts and creators from the Podchaser database. **Does it support episode descriptions?** Yes. The `get_podcast_details` and `list_podcast_episodes` tools retrieve detailed descriptions and show notes for podcasts and episodes.