Version 1 · JSON Schema
An episode is identified by feedUrl plus guid, falling back to enclosureUrl when there is no guid.
| Field | Type | Required | Description |
|---|---|---|---|
guid |
string | no | The item’s RSS guid. May be absent or unstable on private feeds. |
podcastGuid |
string | no | |
feedUrl |
string | yes | URL of the feed the episode was published in (Podcast Index feedUrl). |
feedTitle |
string | no | Title of the feedUrl feed (Podcast Index feedTitle). |
enclosureUrl |
string | yes | Media URL as the feed publishes it; never a redirect target or local URL. |
title |
string | no | |
duration |
number | no | Best-effort length from the feed; use the segment’s mediaDuration when present (seconds) |
private |
true |
no | Present only when the episode’s feed is marked private; see Show reference. |