Skip to content
HALOWERK

Textwerk

headline score

Scores each variant from 100 down by documented penalties: characters above max_chars and words outside min/max (service defaults 70, 4 and 12), words longer than 15 letters, mean syllables per word above 2 (Liang patterns de-1996), share of words over 6 letters above 40 percent (the IW measure of the Wiener Sachtextformel), nominalisations, officialese and jargon labelled in OpenThesaurus, unexplained abbreviations, passive voice, vague forward-reference openers (Das, So, Dies, Hier .),.

POST https://text.halowerk.com/v1/headline-score

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
variantsarrayYesHeadline variants (German).
keywordstringNoOptional key term that should appear early.
max_charsintegerNo
min_wordsintegerNo
max_wordsintegerNo
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "variants"
  ],
  "properties": {
    "variants": {
      "type": "array",
      "minItems": 2,
      "maxItems": 20,
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 300
      },
      "description": "Headline variants (German)."
    },
    "keyword": {
      "type": "string",
      "minLength": 2,
      "maxLength": 60,
      "description": "Optional key term that should appear early."
    },
    "max_chars": {
      "type": "integer",
      "minimum": 20,
      "maximum": 200,
      "default": 70
    },
    "min_words": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "default": 4
    },
    "max_words": {
      "type": "integer",
      "minimum": 3,
      "maximum": 30,
      "default": 12
    }
  }
}

Open original schema

Published input example

{
  "variants": [
    "Neue Regeln für Mieter ab Januar",
    "Durchführung der Novellierung mietrechtlicher Bestimmungen seitens des Gesetzgebers"
  ]
}

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 →