For podcasters
How your show ends up in CleanerCast, and how you can tell us about changes instantly. Short page; no forms; no sign-up.
How inclusion works
If your podcast is in Apple Podcasts, it will automatically appear in CleanerCast. There are three paths that get you there:
- Apple Podcasts auto-discovery. Our nightly discovery sweeps pull from Apple's public RSS charts and the iTunes Search API. A new submission to Apple shows up in our catalog within 1–2 days, no action required on your side.
- Listener search. When a listener searches for a show we don't have yet, we fall back to Apple and import what we find — so even shows our sweeps haven't hit yet get indexed on demand.
- Direct ping (below). The fastest path. You tell us your feed changed; we refresh it within seconds.
The ping endpoint
Ship a new episode, then POST to our ping endpoint. We'll fetch your feed immediately.
curl -X POST "https://app.cleanerpodcasts.com/ping?feed_url=https://example.com/feed.xml"
- No authentication required
- Response is
202 Acceptedwith no body — work happens async - Rate limit: 1 ping per feed URL every 5 minutes, 60 pings per IP per hour
If you run a podcast network and submit many feeds, 60/hour per IP should cover normal operations. If you need higher throughput, get in touch (bottom of page).
Opting out
Add <itunes:block>yes</itunes:block> to
your feed's channel element. We honor it — your show is removed
from our catalog and won't be re-included. This is the same tag
Apple Podcasts recognizes, so one change covers most players.
Feed health
If your feed returns 4xx or 5xx errors for 30 consecutive days, we mark it inactive and stop polling. A successful response (including a ping) reactivates it.
We follow <itunes:new-feed-url> when you move
feeds — no listener action required on their end.
What we do with your content
We do not re-host your audio. Each listener's device downloads episodes directly from your CDN, once, the same as any other podcast player. Their download counts register normally on your side.
CleanerCast's differentiator is profanity filtering. We generate word-level transcripts of episodes a user has saved, keyed to that specific user's downloaded bytes, and apply filter instructions to the audio locally on their device during playback. We don't redistribute transcripts across users and we don't produce or serve a "cleaned" audio file.
Technical feed requirements
- Valid RSS 2.0 with the iTunes namespace
- Items with
<enclosure>pointing to the audio file - Stable
<guid>per episode (we dedupe against it) - Either
ETagorLast-Modifiedheaders on the feed URL (optional but appreciated — lets us skip re-parsing unchanged feeds)
Contact
Escalations, removals, disputes, corrections: podcasters@cleanerpodcasts.com