Docs/Models

ClipCandidate

object

A clip found in a transcript, with copy for a social post.

A clip returned by Search Clips. Pass its source and text to Create Social Post to make a post from it.

Fields

titlestringrequired

Short title of the clip.

textstringrequired

Social post copy that reflects what the clip says.

reasonstringrequired

Why the clip fits the query and why it can interest the audience.

scorenumberrequired

Strength of the clip from 0 to 100.

sourceSocialPostMediaSourcerequired

The clipped span.

Example

{
  "title": "Why the genesis block matters",
  "text": "Bitcoin just went above $100,000. Here is why it started with one block in 2009.",
  "reason": "The guest explains the origin of Bitcoin in under 20 seconds, which fits the news of the day.",
  "score": 86,
  "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
  }
}

Example

{
  "title": "Why the genesis block matters",
  "text": "Bitcoin just went above $100,000. Here is why it started with one block in 2009.",
  "reason": "The guest explains the origin of Bitcoin in under 20 seconds, which fits the news of the day.",
  "score": 86,
  "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
  }
}