Podcast
Podcast operations and RSS feeds
Generates a public RSS feed compatible with Spotify, Apple Music, and other podcast platforms. This endpoint is designed for automated platform distribution - no authentication required.
Platform Integration:
Submit this RSS URL to Spotify for Podcasters, Apple Podcasts Connect
Platforms automatically pull new episodes as they're added via API
Supports iTunes namespace for Apple Podcasts compatibility
Includes proper enclosure tags with audio URLs and metadata
Automation Workflow:
Create podcast show → Get RSS URL from response
Submit RSS URL to podcast platforms (one-time setup)
Add episodes via API → Platforms automatically discover new content
Podcast show ID to generate RSS feed for
abc123-def456-ghi789iTunes-compatible RSS XML feed ready for platform submission
RSS 2.0 XML feed with iTunes namespace extensions
Missing or invalid podcast ID
Internal server error during RSS generation
GET /podcast/rss/{podcastId} HTTP/1.1
Host: api.autocontentapi.com
Accept: */*
<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:itunes="http://www.itunes.com/dtds/podcast-1.0.dtd">
<channel>
<title>My Automated Podcast</title>
<itunes:author>AI Content Creator</itunes:author>
<!-- Episodes automatically included as added via API -->
</channel>
</rss>
Retrieves all podcast shows with their RSS URLs for platform distribution. Each show includes its RSS feed URL for easy platform integration. Supports optional pagination.
Page number for pagination (starts at 1). If not provided, returns all results.
1Number of items per page (max 100, default 50 if page is specified)
20List of podcast shows with RSS URLs for platform submission
Unauthorized - valid API token required
Internal server error
GET /podcast/shows HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
[
{
"id": "text",
"name": "text",
"description": "text",
"author": "text",
"link": "text",
"email": "[email protected]",
"token": "text",
"createdOn": "2025-10-17T19:46:07.704Z",
"updatedOn": "2025-10-17T19:46:07.704Z",
"rssUrl": "https://autocontentapi.com/podcast/rss/abc123"
}
]Creates a new podcast show and returns the RSS URL for platform submission.
Platform Setup Workflow:
Create show via this endpoint → Get RSS URL in response
Submit RSS URL to:
Spotify for Podcasters (https://podcasters.spotify.com)
Apple Podcasts Connect (https://podcastsconnect.apple.com)
Google Podcasts Manager
Other podcast platforms
Start adding episodes via API → Platforms automatically discover new content
Required Metadata: All major podcast platforms require name, description, author, website link, and owner email for contact and verification purposes.
Podcast show name (displayed on Spotify, Apple Music, etc.)
AI-Generated Tech TalkShow description for platform listings and RSS feed
Weekly tech discussions generated by AI, covering the latest in technology and innovation.Host/author name displayed on podcast platforms
AI Content CreatorOfficial website URL for the podcast show
https://mywebsite.com/podcastURL of the podcast show image/artwork
https://mywebsite.com/podcast-artwork.jpgOwner email address for RSS feed and platform registration
[email protected]Podcast show created successfully with RSS URL for platform distribution
Bad request - Missing required fields for platform compatibility
Unauthorized - valid API token required
Internal server error during podcast creation
POST /podcast/shows HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 296
{
"name": "AI-Generated Tech Talk",
"description": "Weekly tech discussions generated by AI, covering the latest in technology and innovation.",
"author": "AI Content Creator",
"link": "https://mywebsite.com/podcast",
"imageUrl": "https://mywebsite.com/podcast-artwork.jpg",
"email": "[email protected]"
}{
"success": true,
"podcastId": "abc123-def456-ghi789",
"rssUrl": "https://autocontentapi.com/podcast/rss/abc123-def456-ghi789"
}Creates a new podcast show with image upload and returns the RSS URL for platform submission. This endpoint accepts multipart/form-data to allow direct image upload alongside podcast metadata.
Platform Setup Workflow:
Create show via this endpoint → Get RSS URL in response
Submit RSS URL to:
Spotify for Podcasters (https://podcasters.spotify.com)
Apple Podcasts Connect (https://podcastsconnect.apple.com)
Google Podcasts Manager
Other podcast platforms
Start adding episodes via API → Platforms automatically discover new content
Required Metadata: All major podcast platforms require name, description, author, website link, and owner email for contact and verification purposes.
Podcast show name (displayed on Spotify, Apple Music, etc.)
AI-Generated Tech TalkShow description for platform listings and RSS feed
Weekly tech discussions generated by AI, covering the latest in technology and innovation.Host/author name displayed on podcast platforms
AI Content CreatorOfficial website URL for the podcast show
https://mywebsite.com/podcastOwner email address for RSS feed and platform registration
[email protected]Podcast show image/artwork file (JPG, PNG, etc.)
Podcast show created successfully with RSS URL for platform distribution
Bad request - Missing required fields or invalid image file
Unauthorized - valid API token required
Internal server error during podcast creation
POST /podcast/shows/with-image HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 262
{
"name": "AI-Generated Tech Talk",
"description": "Weekly tech discussions generated by AI, covering the latest in technology and innovation.",
"author": "AI Content Creator",
"link": "https://mywebsite.com/podcast",
"email": "[email protected]",
"imageFile": "binary"
}{
"success": true,
"podcastId": "abc123-def456-ghi789",
"rssUrl": "https://autocontentapi.com/podcast/rss/abc123-def456-ghi789",
"imageUrl": "https://autocontentapi.com/uploads/podcast-artwork-abc123.jpg"
}Retrieves all podcast episodes owned by the user, including:
Episodes assigned to one or more podcast shows (with podcast show IDs)
Orphaned episodes not yet assigned to any podcast show (with empty podcastShowIds array)
Each episode includes an array of podcast show IDs it belongs to, supporting episodes that appear in multiple shows. Useful for getting a comprehensive view of all published episodes and their distribution across shows. Supports optional pagination.
Page number for pagination (starts at 1). If not provided, returns all results.
1Number of items per page (max 100, default 50 if page is specified)
20List of all episodes with platform-ready metadata and associated podcast show IDs
Unauthorized - valid API token required
Internal server error
GET /podcast/episodes HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
[
{
"id": 1,
"podcastId": "text",
"requestId": "text",
"title": "text",
"description": "text",
"audioTitle": "text",
"audioUrl": "text",
"requestedOn": "2025-10-17T19:46:07.704Z",
"succeededOn": "2025-10-17T19:46:07.704Z",
"scheduledOn": "2025-10-17T19:46:07.704Z",
"fileSize": 1,
"durationSeconds": 1,
"podcastShowIds": [
"abc123-def456",
"ghi789-jkl012"
]
}
]Retrieves all episodes for a specific podcast show. Each episode includes an array of podcast show IDs it belongs to (including the specified one and any others). Useful for monitoring automated podcast publishing and episode management. Supports optional pagination.
The podcast show ID
abc123-def456-ghi789Page number for pagination (starts at 1). If not provided, returns all results.
1Number of items per page (max 100, default 50 if page is specified)
20List of episodes with platform-ready metadata and associated podcast show IDs
Bad request - Invalid podcast ID
Unauthorized - valid API token required
Internal server error
GET /podcast/shows/{podcastId}/episodes HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
[
{
"id": 1,
"podcastId": "text",
"requestId": "text",
"title": "text",
"description": "text",
"audioTitle": "text",
"audioUrl": "text",
"requestedOn": "2025-10-17T19:46:07.704Z",
"succeededOn": "2025-10-17T19:46:07.704Z",
"scheduledOn": "2025-10-17T19:46:07.704Z",
"fileSize": 1,
"durationSeconds": 1,
"podcastShowIds": [
"abc123-def456",
"ghi789-jkl012"
]
}
]Converts existing audio content into a podcast episode for automated platform distribution.
Automation Workflow:
Generate audio content via content API → Get requestId
Add episode via this endpoint → Links audio to podcast show
RSS feed automatically updates with new episode
Spotify, Apple Music, etc. automatically discover and publish new episode
Content Linking: Uses requestId to link existing audio content, enabling seamless conversion of any generated audio into podcast episodes without file uploads.
The podcast show ID to add episode to
abc123-def456-ghi789ID of existing audio content to convert into podcast episode
req_789xyz123abcCustom episode title (optional - defaults to original audio title)
Episode 1: The Future of AICustom episode description (optional - defaults to original audio title)
In this episode, we explore the exciting developments in artificial intelligence...Episode added successfully - will appear on podcast platforms automatically
Bad request - Missing required fields or invalid IDs
Unauthorized - valid API token required
Internal server error during episode creation
POST /podcast/shows/{podcastId}/episodes HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 170
{
"requestId": "req_789xyz123abc",
"title": "Episode 1: The Future of AI",
"description": "In this episode, we explore the exciting developments in artificial intelligence..."
}{
"success": true,
"episodeId": 42,
"message": "Episode added successfully"
}Removes an episode from the podcast show and RSS feed. The episode will be automatically removed from podcast platforms on their next RSS feed refresh.
The episode ID to remove from podcast distribution
42Episode removed successfully - will be removed from platforms automatically
Bad request - Missing or invalid episode ID
Unauthorized - valid API token required
Episode not found or cannot be deleted
Internal server error during episode removal
POST /podcast/episodes/remove HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 16
{
"episodeId": 42
}{
"success": true,
"message": "Episode removed successfully"
}Updates the title and description of a specific podcast episode. The episode must belong to a podcast owned by the authenticated user.
The ID of the episode to update
42New episode title
Updated Episode TitleNew episode description
Updated episode description with more details...Episode updated successfully
Bad request - Missing required fields or invalid episode ID
Unauthorized - valid API token required
Episode not found or cannot be updated
Internal server error during episode update
POST /podcast/episodes/{episodeId} HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 98
{
"title": "Updated Episode Title",
"description": "Updated episode description with more details..."
}{
"success": true,
"message": "Episode updated successfully"
}Imports an entire podcast show and its episodes from an existing RSS feed URL. This is perfect for migrating podcasts from other platforms (Buzzsprout, Anchor, Podbean, etc.) to AutoContent API.
Features:
Preserves ALL RSS metadata (language, copyright, categories, season/episode numbers, etc.)
Smart duplicate detection using GUIDs
Automatically imports and stores podcast artwork
Updates existing podcasts if they already exist
Generates new RSS feed URL that maintains all original metadata
Migration Workflow:
Import your existing podcast from any platform using this endpoint
All metadata is preserved (language, categories, episode numbers, etc.)
Get a new RSS URL that you can submit to Spotify, Apple Podcasts, etc.
Your podcast continues seamlessly with all historical data intact
The RSS feed URL to import from (must end with .rss or contain 'rss' or 'feed')
https://example.com/podcast/feed.rssPodcast imported successfully
Bad request - Invalid or missing RSS URL
Unauthorized - valid API token required
Internal server error during import
POST /podcast/import-rss HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 49
{
"rssUrl": "https://example.com/podcast/feed.rss"
}{
"success": true,
"podcastId": "abc123-def456-ghi789",
"rssUrl": "https://api.autocontentapi.com/podcast/rss/abc123-def456-ghi789"
}Endpoint for removing individual podcast episodes or shows.
Note: This marks content as deleted rather than physically removing it, allowing for potential recovery and maintaining referential integrity.
The podcast or episode ID to mark as deleted
abc123-def456-ghi789Podcast marked as deleted successfully
Bad request - Missing podcast id
Unauthorized - valid API token required
Podcast not found or cannot be deleted
Internal server error during podcast removal
POST /podcast/remove HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 29
{
"id": "abc123-def456-ghi789"
}{
"success": true,
"message": "Podcast deleted successfully"
}Downloads all episodes for the authenticated user as a CSV file. The CSV includes: id, audioUrl, title, and requestedOn fields. Useful for data export, analysis, or backup purposes.
CSV file containing all podcast episodes
id,audioUrl,title,requestedOn "episode1","https://example.com/audio1.mp3","Episode 1: Introduction","2024-01-15T10:30:00.000Z" "episode2","https://example.com/audio2.mp3","Episode 2: Deep Dive","2024-01-16T11:00:00.000Z"Unauthorized - valid API token required
Internal server error during CSV generation
GET /podcast/episodes/csv HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
id,audioUrl,title,requestedOn
"episode1","https://example.com/audio1.mp3","Episode 1: Introduction","2024-01-15T10:30:00.000Z"
"episode2","https://example.com/audio2.mp3","Episode 2: Deep Dive","2024-01-16T11:00:00.000Z"
Downloads all episodes for a specific podcast show as a CSV file. The CSV includes: id, audioUrl, title, and requestedOn fields. Useful for exporting podcast show data for analysis or migration.
The podcast show ID
abc123-def456-ghi789CSV file containing podcast show episodes
id,audioUrl,title,requestedOn "episode1","https://example.com/audio1.mp3","Episode 1: Introduction","2024-01-15T10:30:00.000Z" "episode2","https://example.com/audio2.mp3","Episode 2: Deep Dive","2024-01-16T11:00:00.000Z"Unauthorized - valid API token required
Internal server error during CSV generation
GET /podcast/shows/{podcastId}/episodes/csv HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
id,audioUrl,title,requestedOn
"episode1","https://example.com/audio1.mp3","Episode 1: Introduction","2024-01-15T10:30:00.000Z"
"episode2","https://example.com/audio2.mp3","Episode 2: Deep Dive","2024-01-16T11:00:00.000Z"
Returns 3–8 podcast concepts. Each idea includes a podcast name, description, exactly four episode titles, and AI-estimated 0–100 scores for questionComplexity, topicalDepth, searchVolumeConversational, and contentFreshness. No token required. Rate limited to 10 requests per IP per 24 hours and maximum of 2 concurrent requests per IP.
Optional topic to tailor podcast ideas. If omitted or null, the AI will propose topics.
AI in healthcareStructured list of podcast ideas
Rate limit exceeded (10/day) or too many concurrent requests (2/IP)
Internal server error
POST /podcast/ideas HTTP/1.1
Host: api.autocontentapi.com
Content-Type: application/json
Accept: */*
Content-Length: 28
{
"topic": "AI in healthcare"
}{
"success": true,
"requestId": "text",
"ideas": [
{
"name": "text",
"description": "text",
"episodes": [
"text"
],
"stats": {
"questionComplexity": 1,
"topicalDepth": 1,
"searchVolumeConversational": 1,
"contentFreshness": 1
}
}
]
}