Docs/Models

SocialPost

object

A social post created through the Fountain API.

A post targeting one connected SocialChannel. A post starts as a DRAFT; the publish option on Update Social Post then approves it, schedules it, or publishes it immediately.

Fields

_idstringrequired

Unique post identifier.

contentobjectrequired

The post body and attached media.

contextstringrequired

Context on why this post is recommended. Markdown. Fountain uses it when surfacing the post as a candidate in the dashboard and in email digests.

titlestringrequired

A short title shown with candidate posts in the dashboard and email digests.

textstringrequired

The post text.

uploadsSocialPostUpload[]required

Attached media uploads.

metaobjectrequired

Ownership and lifecycle metadata.

labelstringoptional

Internal label for the post.

channelstringrequired

The channel the post belongs to.

createdstringrequired

ISO-8601 creation time.

updatedstringrequired

ISO-8601 last-update time.

syncedstringoptional

ISO-8601 time of last stats sync with the native platform.

scheduledstringoptional

ISO-8601 scheduled publish time, when scheduled.

publishedstringoptional

ISO-8601 publish time, once published.

deletedstringoptional

ISO-8601 time the post was deleted, by the user or on the native platform.

statusSocialPostStatusrequired

The lifecycle state.

platformobjectrequired

The target platform and its post identifier.

typeSocialPlatformrequired

The platform the post targets.

idstringoptional

The platform-side post id, once published.

linkstringoptional

URL of the post on the platform, once published.

sourceSocialPostMediaSourceoptional

The content segment the post was cut from, when the post is tied to Fountain content.

statsSocialPostStatsoptional

Engagement figures for a published social post.

Example

{
  "_id": "p1q2r3s4t5u6",
  "content": {
    "context": "## Why this post\n\nBitcoin price went above $100,000, and this is generating a lot of engagement on X. The latest episode had John Doe, who discussed the effect of Bitcoin price fluctutations.",
    "title": "Bitcoin price increase",
    "text": "Bitcoin just hit $100,000. Check out my latest episode on why that matters.",
    "uploads": []
  },
  "meta": {
    "label": "Bitcoin above $100k",
    "channel": "a1b2c3d4e5f6",
    "created": "2026-06-01T12:00:00.000Z",
    "updated": "2026-06-01T12:00:00.000Z",
    "synced": "2026-06-02T12:00:00.000Z",
    "published": "2026-06-01T12:00:05.000Z",
    "status": "PUBLISHED"
  },
  "platform": {
    "type": "x",
    "id": "1789012345678901234",
    "link": "https://x.com/fountain_app/status/1789012345678901234"
  },
  "source": {
    "ids": [
      "episode:id:abc123",
      "show:id:xyz789"
    ],
    "media": "https://media.fountain.fm/episodes/abc123.mp3",
    "transcript": "the genesis block was mined in 2009",
    "ts_start": 2477.91,
    "ts_end": 2493.9
  },
  "stats": {
    "views": 1240,
    "likes": 87,
    "comments": 12
  }
}

Example

{
  "_id": "p1q2r3s4t5u6",
  "content": {
    "context": "## Why this post\n\nBitcoin price went above $100,000, and this is generating a lot of engagement on X. The latest episode had John Doe, who discussed the effect of Bitcoin price fluctutations.",
    "title": "Bitcoin price increase",
    "text": "Bitcoin just hit $100,000. Check out my latest episode on why that matters.",
    "uploads": []
  },
  "meta": {
    "label": "Bitcoin above $100k",
    "channel": "a1b2c3d4e5f6",
    "created": "2026-06-01T12:00:00.000Z",
    "updated": "2026-06-01T12:00:00.000Z",
    "synced": "2026-06-02T12:00:00.000Z",
    "published": "2026-06-01T12:00:05.000Z",
    "status": "PUBLISHED"
  },
  "platform": {
    "type": "x",
    "id": "1789012345678901234",
    "link": "https://x.com/fountain_app/status/1789012345678901234"
  },
  "source": {
    "ids": [
      "episode:id:abc123",
      "show:id:xyz789"
    ],
    "media": "https://media.fountain.fm/episodes/abc123.mp3",
    "transcript": "the genesis block was mined in 2009",
    "ts_start": 2477.91,
    "ts_end": 2493.9
  },
  "stats": {
    "views": 1240,
    "likes": 87,
    "comments": 12
  }
}

Fields

_idstringrequired

Unique post identifier.

contentobjectrequired

The post body and attached media.

contextstringrequired

Context on why this post is recommended. Markdown. Fountain uses it when surfacing the post as a candidate in the dashboard and in email digests.

titlestringrequired

A short title shown with candidate posts in the dashboard and email digests.

textstringrequired

The post text.

uploadsSocialPostUpload[]required

Attached media uploads.

metaobjectrequired

Ownership and lifecycle metadata.

labelstringoptional

Internal label for the post.

channelstringrequired

The channel the post belongs to.

createdstringrequired

ISO-8601 creation time.

updatedstringrequired

ISO-8601 last-update time.

syncedstringoptional

ISO-8601 time of last stats sync with the native platform.

scheduledstringoptional

ISO-8601 scheduled publish time, when scheduled.

publishedstringoptional

ISO-8601 publish time, once published.

deletedstringoptional

ISO-8601 time the post was deleted, by the user or on the native platform.

statusSocialPostStatusrequired

The lifecycle state.

platformobjectrequired

The target platform and its post identifier.

typeSocialPlatformrequired

The platform the post targets.

idstringoptional

The platform-side post id, once published.

linkstringoptional

URL of the post on the platform, once published.

sourceSocialPostMediaSourceoptional

The content segment the post was cut from, when the post is tied to Fountain content.

statsSocialPostStatsoptional

Engagement figures for a published social post.

{ "_id": "p1q2r3s4t5u6", "content": { "context": "## Why this post\n\nBitcoin price went above $100,000, and this is generating a lot of engagement on X. The latest episode had John Doe, who discussed the effect of Bitcoin price fluctutations.", "title": "Bitcoin price increase", "text": "Bitcoin just hit $100,000. Check out my latest episode on why that matters.", "uploads": [] }, "meta": { "label": "Bitcoin above $100k", "channel": "a1b2c3d4e5f6", "created": "2026-06-01T12:00:00.000Z", "updated": "2026-06-01T12:00:00.000Z", "synced": "2026-06-02T12:00:00.000Z", "published": "2026-06-01T12:00:05.000Z", "status": "PUBLISHED" }, "platform": { "type": "x", "id": "1789012345678901234", "link": "https://x.com/fountain_app/status/1789012345678901234" }, "source": { "ids": [ "episode:id:abc123", "show:id:xyz789" ], "media": "https://media.fountain.fm/episodes/abc123.mp3", "transcript": "the genesis block was mined in 2009", "ts_start": 2477.91, "ts_end": 2493.9 }, "stats": { "views": 1240, "likes": 87, "comments": 12 } }