Lexicon Garden

org.atpodcasting.episode

A podcast episode. Record key is a UUIDv5 derived from the podcast GUID (as namespace) and the episode's feedItemGuid (as name), enabling deterministic lookup from RSS feed metadata.

Repository @atpodcasting.org did:plc:mla4fbm6mt3f25pehrsl3jum namespace authority
Details · record, key any
Kindrecord
Record keyany
Authorityatpodcasting.org
Indexed
Compare Edit in builder → Fork →

Record

record · key any

Properties

alternateMedia

array

Alternate versions of the episode media (e.g. different formats or audio-only versions of video episodes).

  • maxLength: 10
itemsref
Reference

artwork

blob

Episode-specific artwork. Overrides the podcast artwork when set. Recommended: 1400x1400 to 3000x3000 pixels, square, no alpha channel.

  • maxSize: 5000000
  • accept: image/png, image/jpeg

chapters

ref

Reference to an externally hosted chapters file.

Reference

createdAt

requiredstring · datetime

When the episode record was created.

description

string

A description or show notes for the episode.

  • maxLength: 10000

duration

requiredinteger

Duration of the episode in seconds.

  • minimum: 1

episodeNumber

integer

Episode number within its season or the overall series.

  • minimum: 1

episodeType

string

The type of episode. Defaults to full.

  • knownValues: full | trailer | bonus

explicit

boolean

Whether the episode contains explicit content. Overrides the podcast-level setting when set.

feedItemGuid

requiredstring

The original feed item identifier. Must match the <guid> element of the corresponding RSS feed item. The record key (rkey) is derived from this value as uuid5(<podcast:guid>, feedItemGuid).

  • maxLength: 2000

media

requiredref

The primary media file for the episode.

Reference

podcast

requiredref

Identifies the parent podcast. Since episodes live in the same repository as their podcast, the AT URI is always derivable from the episode's DID and the podcastGuid.

Reference

publishedAt

requiredstring · datetime

When the episode was published.

seasonNumber

integer

Season number of the episode.

  • minimum: 1

title

requiredstring

The title of the episode.

  • maxLength: 500

transcript

array

References to externally hosted transcript files (e.g. VTT, SRT, JSON). Multiple entries allow providing transcripts in different formats.

  • maxLength: 10
itemsref
Reference

#chaptersRef

object

Reference to an externally hosted chapters file.

Properties

mimeType

requiredstring

MIME type of the chapters file (e.g. application/json+chapters).

url

requiredstring · uri

URL of the chapters file.

#mediaRef

object

Reference to an externally hosted media file.

Properties

mimeType

requiredstring

MIME type of the media file (e.g. audio/mpeg, video/mp4).

url

requiredstring · uri

URL of the media file.

#transcriptRef

object

Reference to an externally hosted transcript file.

Properties

language

string · language

Language of the transcript (ISO 639-1 two-letter code, e.g. 'en', 'es', 'pt').

mimeType

requiredstring

MIME type of the transcript file (e.g. text/vtt, application/x-subrip, application/json).

url

requiredstring · uri

URL of the transcript file.

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • place.pod.episode

    record

    A single podcast episode.

  • live.voxport.podcast.episode

    record

    A podcast episode belonging to a series

  • pink.vase.pod.episode

    record

    A podcast episode belonging to a show.

  • org.swappulse.podcastEpisode

    record not from the namespace authority

    A podcast episode (often derived from a voice space recording), mirrored to AT Protocol as a real org.swappulse.podcastEpisode record so episodes are portable and playable across instances.

  • org.atpodcasting.podcast

    record

    A podcast feed/show. Record key is the podcast's Podcasting 2.0 UUIDv5 GUID, enabling direct lookup from RSS feed metadata.