Docs/Content

Content

Load shows, episodes, albums and tracks; load and generate enriched transcripts

Load Content

GEThttps://api.fountain.fm/v1/content/{id}

Load specific content by either a Fountain ID or an external platform ID. The same endpoint resolves shows, episodes, albums and tracks. The returned ContentHit tells you which.

Path parameters

idContentIDrequired

The content to load, e.g. episode:id:abc123 or podcastindex:feed:920666.

Responses

200The matching content.

hitContentHitrequired

The matching content.

Example request

curl -X GET "https://api.fountain.fm/v1/content/{id}" \
  -H "Authorization: Bearer $FOUNTAIN_API_KEY"

Response · 200

{
  "hit": {
    "_id": "episode:id:abc123",
    "_type": "EPISODE",
    "_guid": "abcdef",
    "info": {
      "title": "#2394 - Palmer Luckey",
      "subtitle": "The Joe Rogan Experience",
      "publisher": "Joe Rogan",
      "audio": "https://example.com/episodes/abc123/audio.mp3",
      "video": "https://example.com/episodes/abc123/video.m3u8",
      "duration": 11294,
      "published": "2025-10-16T17:00:00.000Z"
    },
    "links": [
      "show:id:def456"
    ]
  }
}

Load Content Children

GEThttps://api.fountain.fm/v1/content/{id}/children

Load the child content of a parent: the episodes of a show, or the tracks of an album.

Path parameters

idContentIDrequired

The parent content whose children to load.

Responses

200The child content.

hitsContentHit[]required

The child content.

Example request

curl -X GET "https://api.fountain.fm/v1/content/{id}/children" \
  -H "Authorization: Bearer $FOUNTAIN_API_KEY"

Response · 200

{
  "hits": [
    {
      "_id": "episode:id:abc123",
      "_type": "EPISODE",
      "_guid": "abcdef",
      "info": {
        "title": "#2394 - Palmer Luckey",
        "subtitle": "The Joe Rogan Experience",
        "publisher": "Joe Rogan",
        "audio": "https://example.com/episodes/abc123/audio.mp3",
        "video": "https://example.com/episodes/abc123/video.m3u8",
        "duration": 11294,
        "published": "2025-10-16T17:00:00.000Z"
      },
      "links": [
        "show:id:def456"
      ]
    }
  ]
}

Load Transcript

GEThttps://api.fountain.fm/v1/content/{id}/transcript

Load the transcript for an episode. If not present, one can call Generate Transcript

Path parameters

idContentIDrequired

The episode to load the transcript for.

Responses

200The transcript, or the status of the transcription in progress.

segmentsTranscriptSegment[]optional

The transcript, keyed by source. Absent while a transcription is in progress.

statusJobStatusoptional

Transcription status. Returned only while a transcription is in progress.

404No episode with that ID exists, or it has no transcript.

Example request

curl -X GET "https://api.fountain.fm/v1/content/{id}/transcript" \
  -H "Authorization: Bearer $FOUNTAIN_API_KEY"

Response · 200

{
  "segments": [
    {
      "start": 2477.91,
      "end": 2493.9,
      "text": "Imagine that you're an alien."
    }
  ]
}

Generate Transcript

POSThttps://api.fountain.fm/v1/content/{id}/transcript/generate

1 credit per transcript

Queue a job that generates a transcript for an episode from its audio or video.

Pricing

This endpoint is metered: it costs 1 credit per transcript, drawn from your project credits. Charged once when the generate job is queued.

Path parameters

idContentIDrequired

The episode to transcribe.

Responses

200The generate job was queued.

statusJobStatusrequired

Always PENDING for a fresh job.