Profile: podcast-episode

Profile Schema

The podcast-episode profile designates a document that is considered a single episode of a podcast channel. A podcast episode is typically associated with its channel via collection links.

The podcast-episode profile is intended to be used as a “type” profile.

Structure

The podcast-episode profile specifies the following attributes:

Name Type Required? Explanation
explicit boolean Yes A boolean flag indicating if this episode contains explicit content
episodeType string Yes full, trailer, or bonus; see “Episode Type” below
itunes object Yes iTunes specific information; see the “iTunes” section below for more information
copyright string No The copyright policy applied to this episode
episodeGuid string No A GUID identifying this episode
episodePermalink Link No A permalink identifying this episode
episodeNumber integer No This episode’s number within the season (if a season is given)
feedEpisodeTitle string No Episode title as it appears in podcast feeds
seasonNumber integer No The season this episode occurs in
editorialMajorUpdateDateTime date-time string No The editorially-determined last date and time at which the content received major editorial updates. Please use the RFC3339 format set in UTC time (ex: 2021-11-04T08:49:00Z) (ex: 2021-11-04T08:49:00Z). See our tutorial on UTC time for more help.

Episode Type

The episodeType attribute must have one of the following values:

  • full - This is a regular, full episode of content
  • trailer - This is a trailer or promotional episode
  • bonus - This is an extra bonus episode inserted outside of the regular episode “flow”

iTunes

The itunes object contains a set of optional iTunes-specific information:

  • block - Boolean flag to indicate if this episode should be blocked from iTunes (assumed false if not present)

Example podcast-episode document

{
    "id": "12345",
    "profiles": [
        {
            "href": "/v1/profiles/podcast-episode",
            "rels": ["type"]
        },
        {
            "href": "/v1/profiles/document"
        }
    ],

    "assets": {
        "5678": {
            "id": "5678",
            "profiles": [
                {
                    "href": "/v1/profiles/audio",
                    "rels": ["type"]
                },
                {
                    "href": "/v1/profiles/document"
                }
            ],

            "title": "Hero or Menace? We sit down with J. Jonah Jameson and find out.",
            "enclosures": [
                {
                    "href": "https://npr-audio-host.org/spiderman-podcast/episode-1.mp3",
                    "rels": ["tracked", "premium"],
                    "type": "audio/mpeg"
                }
            ]
        }
    },

    "copyright": "Copyright 2021 NPR",
    "episodeGuid": "00000000-0000-0000-0000-000000000000",
    "episodePermalink": {
        "href": "/2021/01/012345/episode-1"
    },
    "episodeNumber": 1,
    "seasonNumber": 1,
    "explicit": false,
    "episodeType": "full",
    "itunes": {
        "block": false
    },
    "feedEpisodeTitle": "Hero or Menace?"
}

© 2025 npr