Skip to content
HALOWERK

Tonwerk

transcript pages

Takes episodes inline or from an RSS feed whose items link transcripts via podcast:transcript (up to four transcripts are fetched, preferring VTT, JSON, SRT, HTML). Parses WebVTT voice spans, SRT cards with "Name:" speaker prefixes, word-level Podcast Namespace JSON segments (merged into sentences) and the cite/time/p HTML format, groups cues into speaker paragraphs (at most 120 words, own rule) and renders one page per episode: lang attribute, skip link, landmarks, one h1, cite for.

POST https://ton.halowerk.com/v1/transcript-pages

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
feed_xmlstringNoRSS 2.0 feed as XML text (alternative to feed_url).
feed_urlstringNoPublic http(s) URL of the RSS feed; fetched when feed_xml is absent (at most 8 MB).
siteobjectYes
episodesarrayNoInline episodes; with a feed, an entry with guid takes its metadata from the matching feed item.
max_fetchintegerNoFeed mode: number of linked transcripts to fetch.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "site"
  ],
  "properties": {
    "feed_xml": {
      "type": "string",
      "minLength": 20,
      "maxLength": 8000000,
      "description": "RSS 2.0 feed as XML text (alternative to feed_url)."
    },
    "feed_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048,
      "description": "Public http(s) URL of the RSS feed; fetched when feed_xml is absent (at most 8 MB)."
    },
    "site": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "base_url"
      ],
      "properties": {
        "base_url": {
          "type": "string",
          "format": "uri",
          "maxLength": 500,
          "description": "Public base URL under which the pages will be published."
        },
        "podcast_title": {
          "type": "string",
          "maxLength": 200
        },
        "language": {
          "type": "string",
          "maxLength": 35,
          "description": "BCP 47 language of the pages (default: feed language or en)."
        }
      }
    },
    "episodes": {
      "type": "array",
      "maxItems": 50,
      "description": "Inline episodes; with a feed, an entry with guid takes its metadata from the matching feed item.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "transcript"
        ],
        "properties": {
          "title": {
            "type": "string",
            "maxLength": 300
          },
          "guid": {
            "type": "string",
            "maxLength": 500
          },
          "pub_date": {
            "type": "string",
            "maxLength": 60
          },
          "audio_url": {
            "type": "string",
            "format": "uri",
            "maxLength": 2048
          },
          "transcript": {
            "type": "string",
            "minLength": 1,
            "maxLength": 2000000
          },
          "format": {
            "type": "string",
            "enum": [
              "auto",
              "vtt",
              "srt",
              "json",
              "html",
              "text"
            ],
            "default": "auto"
          }
        }
      }
    },
    "max_fetch": {
      "type": "integer",
      "minimum": 1,
      "maximum": 4,
      "default": 4,
      "description": "Feed mode: number of linked transcripts to fetch."
    }
  }
}

Open original schema

Published input example

{
  "site": {
    "base_url": "https://example.com/transcripts/",
    "podcast_title": "Example Podcast",
    "language": "en"
  },
  "episodes": [
    {
      "title": "Episode 1: Hello",
      "transcript": "1\n00:00:00,000 --> 00:00:02,500\nWelcome to the show.\n\n2\n00:00:02,500 --> 00:00:05,000\nToday we talk about podcast transcripts.\n",
      "format": "srt"
    }
  ]
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub โ†’