Skip to content
HALOWERK

Textwerk

slugify de

NFKC, then German umlauts and ß are expanded (ä → ae, ö → oe, ü → ue, ß/ẞ → ss) or reduced to the base letter on request; letters without a decomposition are mapped (æ → ae, œ → oe, ø → o, ł → l, đ/ð → d, þ → th, ı → i); remaining diacritics are removed after NFD. & + % € $ @ become words in German or English, apostrophes vanish, everything else becomes the separator. Non-Latin letters are dropped and listed so the caller can transliterate first. The slug is cut at the last separator before.

POST https://text.halowerk.com/v1/slugify-de

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
textstringYesTitle or phrase.
umlautsstringNoexpand: ä → ae (German convention); base: ä → a.
languagestringNoWords for & + % € $ @.
separatorstringNoWord separator in the slug.
max_lengthintegerNoMaximum slug length; the cut happens at a word boundary.
lowercasebooleanNoLower-case the slug.
existingarrayNoSlugs already in use.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "Title or phrase."
    },
    "umlauts": {
      "type": "string",
      "enum": [
        "expand",
        "base"
      ],
      "default": "expand",
      "description": "expand: ä → ae (German convention); base: ä → a."
    },
    "language": {
      "type": "string",
      "enum": [
        "de",
        "en"
      ],
      "default": "de",
      "description": "Words for & + % € $ @."
    },
    "separator": {
      "type": "string",
      "enum": [
        "-",
        "_"
      ],
      "default": "-",
      "description": "Word separator in the slug."
    },
    "max_length": {
      "type": "integer",
      "minimum": 8,
      "maximum": 200,
      "default": 80,
      "description": "Maximum slug length; the cut happens at a word boundary."
    },
    "lowercase": {
      "type": "boolean",
      "default": true,
      "description": "Lower-case the slug."
    },
    "existing": {
      "type": "array",
      "maxItems": 5000,
      "items": {
        "type": "string",
        "maxLength": 300
      },
      "description": "Slugs already in use."
    }
  }
}

Open original schema

Published input example

{
  "text": "Größe & Gewicht: Über 100 Äpfel!"
}

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 →