Skip to content
HALOWERK

Textwerk

term extract

Splits the text into sentences (Intl.Segmenter) and punctuation-free chunks, builds word n-grams up to max_ngram that neither start nor end with a function word (hand-compiled closed-class lists) and contain no function word inside. German candidates must end in a capitalised word (noun head); sentence-initial single words count only if they also appear capitalised elsewhere. Plural variants are merged when the shorter form also occurs. Candidates are ranked by C-value (Frantzi, Ananiadou.

POST https://text.halowerk.com/v1/term-extract

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
textstringYesGerman or English text.
languagestringNoauto detects German or English; other languages are rejected.
max_termsintegerNoMaximum number of returned candidates.
min_frequencyintegerNoMinimum number of occurrences.
max_ngramintegerNoMaximum number of words per candidate.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200000,
      "description": "German or English text."
    },
    "language": {
      "type": "string",
      "enum": [
        "auto",
        "de",
        "en"
      ],
      "default": "auto",
      "description": "auto detects German or English; other languages are rejected."
    },
    "max_terms": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "default": 50,
      "description": "Maximum number of returned candidates."
    },
    "min_frequency": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 2,
      "description": "Minimum number of occurrences."
    },
    "max_ngram": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5,
      "default": 3,
      "description": "Maximum number of words per candidate."
    }
  }
}

Open original schema

Published input example

{
  "text": "Die elektronische Rechnung ersetzt die Papierrechnung. Jede elektronische Rechnung braucht eine Leitweg-ID. Die Leitweg-ID steht im Auftrag.",
  "language": "de"
}

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 →