Skip to content
HALOWERK

Textwerk

vocab list de

Tokenises the text, lemmatises every word with the full-form lexicon german-pos-dict 1.2.4 (CC BY-SA 4.0; 41,902 noun, 10,452 verb and 8,101 adjective lemmas, 2022) and groups occurrences by lemma. Nouns get article, gender, genitive singular and plural (unknown compounds via their dictionary head word, flagged), verbs get 3rd person present, preterite, past participle, separable particle and the perfect auxiliary from English Wiktionary (kaikki.org extract of 2026-10-25, CC BY-SA/GFDL),.

POST https://text.halowerk.com/v1/vocab-list-de

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
textstringYesGerman text (max. 100,000 characters).
word_classesarrayNoWord classes to include.
min_countintegerNoMinimum number of occurrences.
max_itemsintegerNoMaximum number of entries.
sortstringNo
excludearrayNoLemmas the learner already knows (skipped).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100000,
      "description": "German text (max. 100,000 characters)."
    },
    "word_classes": {
      "type": "array",
      "minItems": 1,
      "uniqueItems": true,
      "items": {
        "type": "string",
        "enum": [
          "noun",
          "verb",
          "adjective",
          "adverb"
        ]
      },
      "default": [
        "noun",
        "verb",
        "adjective",
        "adverb"
      ],
      "description": "Word classes to include."
    },
    "min_count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000,
      "default": 1,
      "description": "Minimum number of occurrences."
    },
    "max_items": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "default": 100,
      "description": "Maximum number of entries."
    },
    "sort": {
      "type": "string",
      "enum": [
        "frequency",
        "alphabetical",
        "first_occurrence"
      ],
      "default": "frequency"
    },
    "exclude": {
      "type": "array",
      "maxItems": 2000,
      "items": {
        "type": "string",
        "maxLength": 60
      },
      "description": "Lemmas the learner already knows (skipped)."
    }
  }
}

Open original schema

Published input example

{
  "text": "Die Kinder spielen im Garten. Der Hund läuft schnell über die Wiese, und die Kinder lachen.",
  "max_items": 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

All endpoints in this hub →