Skip to content
HALOWERK

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-search

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
transcriptsarrayYes
querystringYes
modestringNo
max_resultsintegerNo
context_wordsintegerNoWords 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."
    }
  }
}

Open original schema

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

All endpoints in this hub →