Podcast

Podcast operations and RSS feeds

Get iTunes-compatible RSS feed for podcast distribution

get

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:

  1. Create podcast show → Get RSS URL from response

  2. Submit RSS URL to podcast platforms (one-time setup)

  3. Add episodes via API → Platforms automatically discover new content

Path parameters
podcastIdstringRequired

Podcast show ID to generate RSS feed for

Example: abc123-def456-ghi789
Responses
200

iTunes-compatible RSS XML feed ready for platform submission

application/xml
Responsestring

RSS 2.0 XML feed with iTunes namespace extensions

get
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>

Get all podcast shows for automated management

get

Retrieves all podcast shows with their RSS URLs for platform distribution. Each show includes its RSS feed URL for easy platform integration.

Authorizations
Responses
200

List of podcast shows with RSS URLs for platform submission

application/json
get
GET /podcast/shows HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer JWT
Accept: */*

[
  {
    "id": "text",
    "name": "text",
    "description": "text",
    "author": "text",
    "link": "text",
    "email": "[email protected]",
    "token": "text",
    "createdOn": "2025-08-11T23:59:49.277Z",
    "updatedOn": "2025-08-11T23:59:49.277Z",
    "rssUrl": "https://autocontentapi.com/podcast/rss/abc123"
  }
]

Create a new podcast show for automated distribution

post

Creates a new podcast show and returns the RSS URL for platform submission.

Platform Setup Workflow:

  1. Create show via this endpoint → Get RSS URL in response

  2. Submit RSS URL to:

    • Spotify for Podcasters (https://podcasters.spotify.com)

    • Apple Podcasts Connect (https://podcastsconnect.apple.com)

    • Google Podcasts Manager

    • Other podcast platforms

  3. 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.

Authorizations
Body
namestringRequired

Podcast show name (displayed on Spotify, Apple Music, etc.)

Example: AI-Generated Tech Talk
descriptionstringRequired

Show description for platform listings and RSS feed

Example: Weekly tech discussions generated by AI, covering the latest in technology and innovation.
authorstringRequired

Host/author name displayed on podcast platforms

Example: AI Content Creator
linkstring · uriRequired

Official website URL for the podcast show

Example: https://mywebsite.com/podcast
imageUrlstring · uriRequired

URL of the podcast show image/artwork

Example: https://mywebsite.com/podcast-artwork.jpg
emailstring · emailRequired

Owner email address for RSS feed and platform registration

Example: [email protected]
Responses
201

Podcast show created successfully with RSS URL for platform distribution

application/json
post
POST /podcast/shows HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer JWT
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"
}

Create a new podcast show with image upload for automated distribution

post

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:

  1. Create show via this endpoint → Get RSS URL in response

  2. Submit RSS URL to:

    • Spotify for Podcasters (https://podcasters.spotify.com)

    • Apple Podcasts Connect (https://podcastsconnect.apple.com)

    • Google Podcasts Manager

    • Other podcast platforms

  3. 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.

Authorizations
Body
namestringRequired

Podcast show name (displayed on Spotify, Apple Music, etc.)

Example: AI-Generated Tech Talk
descriptionstringRequired

Show description for platform listings and RSS feed

Example: Weekly tech discussions generated by AI, covering the latest in technology and innovation.
authorstringRequired

Host/author name displayed on podcast platforms

Example: AI Content Creator
linkstring · uriRequired

Official website URL for the podcast show

Example: https://mywebsite.com/podcast
emailstring · emailRequired

Owner email address for RSS feed and platform registration

Example: [email protected]
imageFilestring · binaryRequired

Podcast show image/artwork file (JPG, PNG, etc.)

Responses
201

Podcast show created successfully with RSS URL for platform distribution

application/json
post
POST /podcast/shows/with-image HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer JWT
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"
}

Get all podcast episodes for user

get

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.

Authorizations
Responses
200

List of all episodes with platform-ready metadata and associated podcast show IDs

application/json
get
GET /podcast/episodes HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer JWT
Accept: */*

[
  {
    "id": 1,
    "podcastId": "text",
    "requestId": "text",
    "title": "text",
    "description": "text",
    "audioTitle": "text",
    "audioUrl": "text",
    "requestedOn": "2025-08-11T23:59:49.277Z",
    "succeededOn": "2025-08-11T23:59:49.277Z",
    "fileSize": 1,
    "durationSeconds": 1,
    "podcastShowIds": [
      "abc123-def456",
      "ghi789-jkl012"
    ]
  }
]

Get all episodes for automated podcast management

get

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.

Authorizations
Path parameters
podcastIdstringRequired

The podcast show ID

Example: abc123-def456-ghi789
Responses
200

List of episodes with platform-ready metadata and associated podcast show IDs

application/json
get
GET /podcast/shows/{podcastId}/episodes HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer JWT
Accept: */*

[
  {
    "id": 1,
    "podcastId": "text",
    "requestId": "text",
    "title": "text",
    "description": "text",
    "audioTitle": "text",
    "audioUrl": "text",
    "requestedOn": "2025-08-11T23:59:49.277Z",
    "succeededOn": "2025-08-11T23:59:49.277Z",
    "fileSize": 1,
    "durationSeconds": 1,
    "podcastShowIds": [
      "abc123-def456",
      "ghi789-jkl012"
    ]
  }
]

Add episode to podcast for automated distribution

post

Converts existing audio content into a podcast episode for automated platform distribution.

Automation Workflow:

  1. Generate audio content via content API → Get requestId

  2. Add episode via this endpoint → Links audio to podcast show

  3. RSS feed automatically updates with new episode

  4. 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.

Authorizations
Path parameters
podcastIdstringRequired

The podcast show ID to add episode to

Example: abc123-def456-ghi789
Body
requestIdstringRequired

ID of existing audio content to convert into podcast episode

Example: req_789xyz123abc
titlestringOptional

Custom episode title (optional - defaults to original audio title)

Example: Episode 1: The Future of AI
descriptionstringOptional

Custom episode description (optional - defaults to original audio title)

Example: In this episode, we explore the exciting developments in artificial intelligence...
Responses
201

Episode added successfully - will appear on podcast platforms automatically

application/json
post
POST /podcast/shows/{podcastId}/episodes HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer JWT
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"
}

Remove episode from automated podcast distribution

post

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.

Authorizations
Body
episodeIdintegerRequired

The episode ID to remove from podcast distribution

Example: 42
Responses
200

Episode removed successfully - will be removed from platforms automatically

application/json
post
POST /podcast/episodes/remove HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 16

{
  "episodeId": 42
}
{
  "success": true,
  "message": "Episode removed successfully"
}

Update podcast episode title and description

post

Updates the title and description of a specific podcast episode. The episode must belong to a podcast owned by the authenticated user.

Authorizations
Path parameters
episodeIdintegerRequired

The ID of the episode to update

Example: 42
Body
titlestringRequired

New episode title

Example: Updated Episode Title
descriptionstringRequired

New episode description

Example: Updated episode description with more details...
Responses
200

Episode updated successfully

application/json
post
POST /podcast/episodes/{episodeId} HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer JWT
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"
}

Remove podcast from distribution

post

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.

Authorizations
Body
idstringRequired

The podcast or episode ID to mark as deleted

Example: abc123-def456-ghi789
Responses
200

Podcast marked as deleted successfully

application/json
post
POST /podcast/remove HTTP/1.1
Host: api.autocontentapi.com
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 29

{
  "id": "abc123-def456-ghi789"
}
{
  "success": true,
  "message": "Podcast deleted successfully"
}
PreviousShareNextFeeds