Docs/Search

Search

Search content, transcripts, clips and profiles; look up podcast GUIDs.

Search Content

POSThttps://api.fountain.fm/v1/search/content

Full-text search across content titles and subtitles.

Request body

querystringrequired

Keywords to match in titles and subtitles.

typesContentType[]optional

Content types to return. Omit to search every type.

parentContentIDoptional

Only return children of this content. Fountain content ID {type}:id:{id}. The ID of fountain.fm/show/{id} is show:id:{id}.

Responses

200The matching content, most relevant first.
hitsContentHit[]required

The matching content.

Example request
curl -X POST "https://api.fountain.fm/v1/search/content" \
  -H "Authorization: Bearer $FOUNTAIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"lucky","types":["SHOW","EPISODE"]}'
Request body
{
  "query": "lucky",
  "types": [
    "SHOW",
    "EPISODE"
  ]
}
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",
        "show:guid:abcdef"
      ]
    }
  ]
}

Search Transcripts

POSThttps://api.fountain.fm/v1/search/transcripts

Search episode transcripts indexed by Fountain.

Request body

querystringrequired

Keywords to match in transcripts.

idsContentID[]optional

IDs of the episodes to search.

parentContentIDoptional

Only search children of this content. Fountain content ID {type}:id:{id}. The ID of fountain.fm/show/{id} is show:id:{id}.

Responses

200The matching content with relevant transcript segments.
hitsobject[]required

One hit per episode with matching transcript segments.

hitContentHitrequired

The matching content.

segmentsTranscriptSegment[]required

The relevant transcript segments.

Example request
curl -X POST "https://api.fountain.fm/v1/search/transcripts" \
  -H "Authorization: Bearer $FOUNTAIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"aliens","parent":"show:id:Z3Bnva1FtoO6Vc8NN4Zr"}'
Request body
{
  "query": "aliens",
  "parent": "show:id:Z3Bnva1FtoO6Vc8NN4Zr"
}
Response · 200
{
  "hits": [
    {
      "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",
          "show:guid:abcdef"
        ]
      },
      "segments": [
        {
          "start": 2477.91,
          "end": 2493.9,
          "text": "Imagine that you're an alien."
        }
      ]
    }
  ]
}

Search Clips

POSThttps://api.fountain.fm/v1/search/clips

Find up to 3 clips in a show's transcripts that match a context, such as a news story or a topic, strongest first. Pass a candidate's source and text to Create Social Post to make a post. Returns an empty list when no clip is strong enough.

Request body

querystringrequired

Context for the clips, such as a news story, a topic or a mood, in plain words.

idsContentID[]optional

IDs of the episodes to search. Omit to search every episode.

parentContentIDrequired

The show to search.

compilationbooleanoptional

Find one compilation of moments from several episodes instead of single clips.

Responses

200The matching clips, strongest first.
candidatesClipCandidate[]required

Up to 3 clips.

Example request
curl -X POST "https://api.fountain.fm/v1/search/clips" \
  -H "Authorization: Bearer $FOUNTAIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"Bitcoin went above $100,000","parent":"show:id:xyz789"}'
Request body
{
  "query": "Bitcoin went above $100,000",
  "parent": "show:id:xyz789"
}
Response · 200
{
  "candidates": [
    {
      "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
      }
    }
  ]
}

Search Profiles

POSThttps://api.fountain.fm/v1/search/profiles

Search names, usernames and NIP-05 identifiers. Returns up to 50 profiles, ranked by influence. A bare npub resolves a profile directly; a Fountain lightning address (alice@fountain.fm) matches its handle.

Request body

querystringrequired

Non-empty search query.

Responses

200The matching profiles, most influential first.
profilesNostrProfile[]required

The matching profiles.

Example request
curl -X POST "https://api.fountain.fm/v1/search/profiles" \
  -H "Authorization: Bearer $FOUNTAIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"alice"}'
Request body
{
  "query": "alice"
}
Response · 200
{
  "profiles": [
    {
      "pubkey": "a1b2c3d4e5f60718293a4b5c6d7e8f90a1b2c3d4e5f60718293a4b5c6d7e8f90",
      "npub": "npub1c2d3e4f5g6h7i8j9k0l1m2n3o4p5q6r7s8t9u0v1w2x3y4z5a6b7c8d9e0f",
      "handle": "alice",
      "display": {
        "name": "Alice",
        "username": "alice",
        "about": "Podcaster and bitcoiner.",
        "picture": "https://media.fountain.fm/profiles/alice/avatar.jpg",
        "nip05": "alice@fountain.fm",
        "lud16": "alice@fountain.fm"
      },
      "stats": {
        "following": 128,
        "followers": 4210
      }
    }
  ]
}

Lookup Podcast GUIDs

POSThttps://api.fountain.fm/v1/search/lookup

Find content by RSS feed <podcast:guid> and RSS item <guid>.

Request body

idstringrequired

Podcast feed GUID as podcast:guid:{guid}, or RSS item <guid> value as podcast:item:guid:{guid}. GUIDs must contain no whitespace. Item lookups also require parent.

parentstringoptional

Parent feed GUID as podcast:guid:{guid}, with no whitespace. Required for item lookups to return only matches belonging to this feed; ignored for feed lookups.

Responses

200The content with the matching GUID.
hitsContentHit[]required
Example request
curl -X POST "https://api.fountain.fm/v1/search/lookup" \
  -H "Content-Type: application/json" \
  -d '{"id":"podcast:item:guid:abcdef","parent":"podcast:guid:9b...e1"}'
Request body
{
  "id": "podcast:item:guid:abcdef",
  "parent": "podcast:guid:9b...e1"
}
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",
        "show:guid:abcdef"
      ]
    }
  ]
}