Skip to content
HALOWERK

Textwerk

emoji replace

Recognises all sequences of emoji-test.txt 17.0 (ZWJ sequences, skin tones, flags, keycaps) by longest match. By default fully-qualified, minimally-qualified and component sequences count; text-style characters such as © or ❤ without U+FE0F only with include_unqualified. Names: English CLDR short names from emoji-test.txt, German tts names from CLDR 48 annotations (fallback to English is marked). After a removal, only the spaces directly around the removed emoji are tidied (no double space,.

POST https://text.halowerk.com/v1/emoji-replace

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
textstringYesText with emojis.
modestringNoremove, replace by name, replace by placeholder, or only list the emojis.
languagestringNoLanguage of names in mode name.
name_formatstringNoTemplate for mode name; must contain {name}.
placeholderstringNoReplacement in mode placeholder.
include_unqualifiedbooleanNoAlso treat text-style characters (©, ®, ™, ❤ without U+FE0F) as emojis.
tidy_whitespacebooleanNoRemove the space left directly at a removed emoji (only there).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100000,
      "description": "Text with emojis."
    },
    "mode": {
      "type": "string",
      "enum": [
        "remove",
        "name",
        "placeholder",
        "list"
      ],
      "default": "remove",
      "description": "remove, replace by name, replace by placeholder, or only list the emojis."
    },
    "language": {
      "type": "string",
      "enum": [
        "en",
        "de"
      ],
      "default": "en",
      "description": "Language of names in mode name."
    },
    "name_format": {
      "type": "string",
      "maxLength": 50,
      "default": ":{name}:",
      "description": "Template for mode name; must contain {name}."
    },
    "placeholder": {
      "type": "string",
      "maxLength": 50,
      "default": "",
      "description": "Replacement in mode placeholder."
    },
    "include_unqualified": {
      "type": "boolean",
      "default": false,
      "description": "Also treat text-style characters (©, ®, ™, ❤ without U+FE0F) as emojis."
    },
    "tidy_whitespace": {
      "type": "boolean",
      "default": true,
      "description": "Remove the space left directly at a removed emoji (only there)."
    }
  }
}

Open original schema

Published input example

{
  "text": "Super 👍 Arbeit 🎉!",
  "mode": "name",
  "language": "de",
  "name_format": "[{name}]"
}

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 →