Tonwerk
feed fulltext search
Indexes up to 300 supplied transcripts (WebVTT, SRT, Podcast Namespace JSON or HTML, plain text) per call and searches them; nothing is stored between calls and no feed is crawled. Passages are cues (word-level JSON merged into sentences); tokens are lower-cased with diacritics folded (ß = ss). Query terms (Snowball stop words removed outside phrase mode, trailing * for prefix match) are ranked with BM25 (k1 1.2, b 0.75) at passage level; mode all requires every term in the passage, any one.
POST https://ton.halowerk.com/v1/feed-fulltext-searchInputs
| Field | Type | Required | Description |
|---|---|---|---|
| transcripts | array | Yes | |
| query | string | Yes | |
| mode | string | No | |
| max_results | integer | No | |
| context_words | integer | No | Words of context on each side of the first match. |
Show full input schema
{
"type": "object",
"additionalProperties": false,
"required": [
"transcripts",
"query"
],
"properties": {
"transcripts": {
"type": "array",
"minItems": 1,
"maxItems": 300,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"id",
"content"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 300,
"description": "Episode identifier (e.g. GUID)."
},
"title": {
"type": "string",
"maxLength": 300
},
"content": {
"type": "string",
"minLength": 1,
"maxLength": 2000000
},
"format": {
"type": "string",
"enum": [
"auto",
"vtt",
"srt",
"json",
"html",
"text"
],
"default": "auto"
}
}
}
},
"query": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"mode": {
"type": "string",
"enum": [
"all",
"any",
"phrase"
],
"default": "all"
},
"max_results": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 20
},
"context_words": {
"type": "integer",
"minimum": 3,
"maximum": 40,
"default": 12,
"description": "Words of context on each side of the first match."
}
}
}Published input example
{
"query": "podcast trailer",
"transcripts": [
{
"id": "ep-12",
"title": "Trailer basics",
"content": "WEBVTT\n\n00:00:01.000 --> 00:00:04.000\n<v Sarah>Do we need a podcast trailer?"
}
]
}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