Docs/Overview

Fountain Docs

Run your podcast from Claude, ChatGPT or any other AI agent, or build on the Fountain API.

Guides

Getting startedConnect your agent and make your first clips.Connect your agentConnect Fountain to Claude, ChatGPT or any agent that supports MCP.Finding clipsAsk for clips from an episode and get drafts with the posts already written.Styling clipsSet your captions, overlays and colours once, and every clip uses them.Publishing clipsApprove the drafts you like, render them and post them to your channels.Daily GrowthEvery morning, your agent checks the news and drafts clips from episodes that match.Publishing episodesGive your agent the file and a time. It publishes or schedules the episode with its show notes.AnalyticsAsk about downloads, earnings and how each clip did.Archive searchAsk what was said in any episode, by whom and when.

Endpoints

Project7 endpointsManage projects, credits, feeds, shows, preferences and email reports.
Content4 endpointsLoad content and generate transcripts.
Search4 endpointsSearch content, transcripts and profiles; look up podcast GUIDs.
Publishing12 endpointsManage hosted feeds and items. Feeds represent shows; items represent episodes.
Uploads3 endpointsUpload media for feeds, items and social posts.
Social8 endpointsConnect social channels and publish posts to them.

Models

AudioMetadataID3 tags extracted from an uploaded audio file.
ContentHitThe core content object returned across the API.
ContentIDA string that uniquely identifies some content on Fountain.
ContentTypeThe kind of content a hit represents.
FeedA podcast feed you host.
ItemAn item in a feed you host.
ItemStatusThe publishing state of an item.
JobStatusThe lifecycle state of an asynchronous job.
MediaA tracked media upload.
MediaKindThe kind of media an upload holds.
MediaStatusThe processing state of a media upload.
NostrProfileA Nostr profile indexed in the Fountain graph.
PodcastCategoryA category a podcast show can be listed under.
ProjectOverviewAn API project, its credit balance and connected content.
SocialChannelA connected social channel.
SocialChannelStatusThe connection state of a social channel.
SocialPlatformA social platform a project can connect a channel to.
SocialPostA social post created through the Fountain API.
SocialPostMediaSourceThe segment of Fountain content a social post was cut from.
SocialPostPublishModeHow a post should be approved, scheduled or published when updated.
SocialPostStatsEngagement figures for a published social post.
SocialPostStatusThe lifecycle state of a social post.
SocialPostUploadMedia attached to a social post.
SocialPostUploadTypeThe type of media attached to a social post.
StatsA feed’s or item’s download and payment statistics.
StatsBucketA metric attributed to a single time bucket.
StatsMetricOne period’s aggregate figures.
StatsRowOne group’s figures: current totals, the prior window, and an optional time series.
TranscriptSegmentA span of transcript text with start and end times.

For agents

Add .md to any docs URL for its Markdown, or start from docs.md for the whole reference in one file.