Submit a new podcast to the Podcast Index by feed URL or iTunes ID using the write-permission Add endpoints
domain: podcastindex-org.github.io · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Register for a Podcast Index API key and confirm it has write permission
Build the required Amazon-style signed request headers: User-Agent, X-Auth-Date, X-Auth-Key and Authorization
Call GET or POST api.podcastindex.org/api/1.0/add/byfeedurl with a url parameter to add a podcast by its RSS feed URL
Alternatively call add/byitunesid with an id parameter to add a podcast by its iTunes identifier
Inspect the JSON response for an existing feedId, since an already-indexed feed returns its current ID instead of erroring
Handle 400 and 401 responses for malformed requests or invalid write-key auth
Known gotchas
add/byfeedurl and add/byitunesid require a write-permission API key, unlike PodcastIndex's read-only search endpoints
if the feed is already indexed, the call just returns the existing Feed ID rather than duplicating it
this endpoint indexes a brand-new feed; it does not notify the index that an already-indexed feed has fresh content, that is a separate hub/pubnotify call
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?