Webhook filters let you receive webhook events whenever a podcast contains data you care about, rather than receiving an event for every new podcast and episode.

Whenever new podcast data is released, we check to see if it matches any of the regex patterns you’ve set up and only send you the events that match your criteria.

Use-cases for Webhook Filters

• Brand monitoring - Get notified when your company or product is mentioned on a new episode. Set up a filter with regex like \\byour-brand\\b.
• Sales intelligence - Track when prospects or competitors appear on podcasts. Combine this with our transcript API to extract context that can be used in lead scoring.
• Industry research — Monitor keywords or key executives in your industry. For example, a filter with regex like \\b(FDA approval|clinical trial|drug recall|Phase [1-3]|NDA filing)\\b keeps you on top of latest pharma trends.

Add a Webhook Filter

Once you've set up a Taddy API webhook endpoint, you can add one or more webhook filters. Click on ‘Add Filter’.

Then, set up your filter by:

1. Selecting a filter type (e.g., podcastepisode.created).
2. Adding a regex expression

In the example below I’ve set up a filter to only receive webhook events when a new episode’s description contains “zune” or “iPod”.

On Taddy’s server, whenever a new episode is released, we check whether it matches any of your filters. If it does, we send the event to your webhook endpoint. Here's an example webhook event for a newly released episode that matches our example filter:

// EXAMPLE WEBHOOK event for a PodcastEpisode
{
  "uuid": "5c04591a-ac2e-49a2-acf8-417776ab7bf0",
  "taddyType": "podcastepisode",
  "action": "created",
  "timestamp": 1762077600,
  "data": {
    "uuid": "5c04591a-ac2e-49a2-acf8-417776ab7bf0",
    "hash": "e9741462006248fc1ce94ac501240873e75a644414f41e638ca606664e706218",
    "name": "Version History: Zune",
    "description": "<p>In 2006, Microsoft came for the iPod's throne with an innovative MP3 player called the Zune. It had a bunch of features the iPod didn't: WiFi, music sharing, a bigger screen, a beautiful UI, even an FM radio. And to hear Microsoft describe it, it was even kind of a social network. Nilay Patel and Victoria Song join David Pierce to break down why, despite all that, the Zune never really took off. And why it came in brown.</p>\\n<p><strong>If you like the show, ⁠</strong><a href=\\"<https://link.chtbl.com/versionhistory\\>">⁠subscribe to the Version History feed⁠</a><strong>⁠ to make sure you get every new episode.</strong></p>\\n<p><strong></strong><a href=\\"<https://www.theverge.com/subscribe\\>">⁠Subscribe to The Verge⁠</a> for unlimited access to <a href=\\"<http://theverge.com/\\>">⁠</a><a href=\\"<http://theverge.com/\\>">theverge.com</a><a href=\\"<http://theverge.com/\\>">⁠</a>, subscriber-exclusive newsletters, and our <a href=\\"<https://www.theverge.com/bulletin/795051/verge-podcast-ad-free-set-up-how-to\\>">⁠ad-free podcast feed⁠</a>.</p>\\n<p>We love hearing from you! Email your questions and thoughts to <a href=\\"<mailto:[email protected]>\\">⁠[email protected]⁠</a> or call us at 866-VERGE11.</p><p> </p><p>Learn more about your ad choices. Visit <a href=\\"<https://podcastchoices.com/adchoices\\">podcastchoices.com/adchoices</a></p>">,
    "imageUrl": null,
    "datePublished": 1762077600,
    "guid": "b1b3b8a4-97ea-11f0-8c9e-a31de8fbd080",
    "subtitle": null,
    "audioUrl": "<https://www.podtrac.com/pts/redirect.mp3/pdst.fm/e/pscrb.fm/rss/p/traffic.megaphone.fm/VMP7431183096.mp3?updated=1762092793>",
    "videoUrl": null,
    "fileLength": null,
    "fileType": "audio/mpeg",
    "duration": 4638,
    "episodeType": "FULL",
    "seasonNumber": null,
    "episodeNumber": null,
    "websiteUrl": null,
    "isExplicitContent": false,
    "isRemoved": null,
    "podcastSeries": {
      "uuid": "4bb5a32e-3c92-4669-b8f1-6360ada2cc94",
      "name": "The Vergecast",
      "rssUrl": "<https://feeds.megaphone.fm/vergecast>",
      "itunesId": 430333725,
      "language": "ENGLISH",
      "genres": ["PODCASTSERIES_TECHNOLOGY", "PODCASTSERIES_NEWS", "PODCASTSERIES_NEWS_TECH"],
      "popularityRank": "TOP_2000"
    }
  },
  matchingFilters: ['12345678-abcdefgh-12345678-abcdefgh']
}

Notes:

• You can set up multiple filters, when there is a new podcast or episode data, we check to see if it successfully matches regex expressions from ANY of your filters.
• By default, Business accounts come with 100 webhook filters, contact [email protected] if you’d like to add more to your account.