Tonwerk
episode topic map
Takes 2-300 episodes inline or from an RSS feed (title plus description, content:encoded or itunes:summary, HTML removed). Tokens are lower-cased words of at least three letters without German and English Snowball stop words; plural and inflection variants are folded onto the shortest form present in the corpus (s, e, n, en, es, er endings; own rule), adjacent content words also form bigrams. Weights are sublinear TF-IDF (1+ln tf, smooth idf). Topics are terms that occur in at least.
POST https://ton.halowerk.com/v1/episode-topic-mapInputs
| Field | Type | Required | Description |
|---|---|---|---|
| feed_xml | string | No | RSS 2.0 feed as XML text (alternative to feed_url). |
| feed_url | string | No | Public http(s) URL of the RSS feed; fetched when feed_xml is absent (at most 8 MB). |
| episodes | array | No | |
| top_terms | integer | No | |
| max_topics | integer | No | |
| min_episodes | integer | No | Minimum number of episodes that share a topic term. |
Show full input schema
{
"type": "object",
"additionalProperties": false,
"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)."
},
"episodes": {
"type": "array",
"minItems": 2,
"maxItems": 300,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"title"
],
"properties": {
"id": {
"type": "string",
"maxLength": 300
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 500
},
"text": {
"type": "string",
"maxLength": 200000,
"description": "Show notes or transcript text."
},
"date": {
"type": "string",
"maxLength": 60
}
}
}
},
"top_terms": {
"type": "integer",
"minimum": 3,
"maximum": 15,
"default": 8
},
"max_topics": {
"type": "integer",
"minimum": 2,
"maximum": 40,
"default": 12
},
"min_episodes": {
"type": "integer",
"minimum": 2,
"maximum": 20,
"default": 2,
"description": "Minimum number of episodes that share a topic term."
}
}
}Published input example
{
"feed_url": "https://podnews.net/rss",
"max_topics": 10
}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
- Tonwerk0.01 USDC
accessible transcript html
POSThttps://ton.halowerk.com/v1/accessible-transcript-htmlParses SRT or WebVTT (voice tags <v Name>, "NAME:" prefixes and ">>" speaker changes) or a segments array, merges consecutive cues of the same speaker into turns (a new paragraph after a pause longer than paragraph_gap_s), and writes semant
- Tonwerk0.01 USDC
ad disclosure audio
POSThttps://ton.halowerk.com/v1/ad-disclosure-audioDecodes the complete supplied clip to mono 16 kHz using resource-limited ffmpeg, checks for speech with Silero VAD v6.2 (MIT), and transcribes locally with the pinned Whisper base ONNX model (MIT / Apache-2.0). Conservative English phrase r
- Tonwerk0.005 USDC
ad insertion markers
POSThttps://ton.halowerk.com/v1/ad-insertion-markersRuns ffmpeg 6.1 silencedetect on the episode audio (base64 or URL, at most 10 MiB) and builds mid-roll candidates from internal silences and from Podcasting 2.0 chapter boundaries (a boundary inside a silence or snapped to the nearest silen