Docs/Models

Feed

object

A podcast feed you host.

A podcast feed you host on Fountain, the editable record behind a public Show. Editing a feed is how you edit the show listeners see. To publish, a feed needs title, author, description, image and at least one category.

Fields

idstringrequired

Hosting ID, used everywhere in this API.

fountain_idstringoptional

Public Fountain Show ID; absent until the feed is published. Read-only.

titlestringoptional

Feed title.

authorstringoptional

Feed author.

descriptionstringoptional

Feed description.

categoriesPodcastCategory[]required

The categories the feed is listed under, e.g. Technology. Max 3.

explicitbooleanrequired

Whether the feed is marked explicit.

display_emailbooleanrequired

Whether the owner email is shown publicly in the feed.

linksstring[]required

Associated links, each a URL.

imagestringoptional

Cover artwork URL.

vocabularystring[]required

Custom terms that bias the AI transcriber, e.g. proper nouns. ≤224-token capacity.

rss_urlstringrequired

The public RSS feed URL.

updatedstringrequired

ISO-8601 timestamp of the last update.

Example

{
  "id": "a1b2c3d4",
  "fountain_id": "show:id:def456",
  "title": "Citadel Dispatch",
  "author": "ODELL",
  "description": "Freedom tech and Bitcoin, live and unedited.",
  "categories": [
    "Technology",
    "News"
  ],
  "explicit": false,
  "display_email": false,
  "links": [
    "https://citadeldispatch.com"
  ],
  "image": "https://media.fountain.fm/shows/a1b2c3d4/cover.jpg",
  "vocabulary": [
    "Nostr",
    "sats"
  ],
  "rss_url": "https://feeds.fountain.fm/a1b2c3d4",
  "updated": "2026-02-18T22:03:53.467Z"
}