Skip to content
HALOWERK

Tonwerk

multi call themes

Tokenises every call (Snowball stop words plus a disclosed list of call fillers removed, light stemming), counts stemmed words and adjacent two-word phrases per call and keeps those occurring in at least min_calls calls. Terms are ranked by number of calls, phrase length and frequency; a term joins a theme when its set of calls overlaps the theme's (Jaccard ≥ 0.7) and both occur within 20 words of each other in at least half of the shared calls; single words already covered by a phrase with.

POST https://ton.halowerk.com/v1/multi-call-themes

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
callsarrayYesCalls with id and transcript or segments.
min_callsintegerNoA term must occur in at least this many calls (default 2).
max_themesintegerNoNumber of themes returned (default 15).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "calls"
  ],
  "properties": {
    "calls": {
      "type": "array",
      "minItems": 2,
      "maxItems": 50,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id"
        ],
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 64
          },
          "transcript": {
            "type": [
              "string",
              "object",
              "array"
            ],
            "minLength": 1,
            "maxLength": 400000,
            "description": "Transcript (WebVTT, SRT, JSON or plain text)."
          },
          "segments": {
            "type": "array",
            "minItems": 1,
            "maxItems": 5000,
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "start",
                "end",
                "text"
              ],
              "properties": {
                "start": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 86400,
                  "description": "Start time in seconds."
                },
                "end": {
                  "type": "number",
                  "minimum": 0,
                  "maximum": 86400,
                  "description": "End time in seconds."
                },
                "speaker": {
                  "type": "string",
                  "maxLength": 100,
                  "description": "Speaker label as delivered by diarisation, e.g. \"A\", \"SPEAKER_00\" or \"Agent\"."
                },
                "text": {
                  "type": "string",
                  "maxLength": 5000,
                  "description": "Text of the segment."
                }
              }
            }
          }
        }
      },
      "description": "Calls with id and transcript or segments."
    },
    "min_calls": {
      "type": "integer",
      "minimum": 2,
      "maximum": 50,
      "default": 2,
      "description": "A term must occur in at least this many calls (default 2)."
    },
    "max_themes": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 15,
      "description": "Number of themes returned (default 15)."
    }
  }
}

Open original schema

Published input example

{
  "calls": [
    {
      "id": "c1",
      "transcript": "My invoice was charged twice this month."
    },
    {
      "id": "c2",
      "transcript": "The invoice shows a double charge, charged twice."
    },
    {
      "id": "c3",
      "transcript": "The router keeps losing the connection."
    },
    {
      "id": "c4",
      "transcript": "Router connection drops every evening."
    }
  ]
}

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 →