Textwerk
fuzzy name match
Normalises names (NFKC, case, ICAO-style folding ä → ae, ø → oe, diacritics removed, & / und / and unified), detects legal-form suffixes from the GLEIF ISO 20275 Entity Legal Forms code list v1.6 for the chosen countries (default DE, AT, CH), lists the matching ELF entries and removes the suffix from the core name, removes academic titles and reorders "Surname, Given" for persons. Score = 0.35 token-sorted Levenshtein similarity + 0.25 Jaro-Winkler + 0.25 token Dice + 0.15 Dice of Cologne.
POST https://text.halowerk.com/v1/fuzzy-name-matchInputs
| Field | Type | Required | Description |
|---|---|---|---|
| query | string | Yes | Name to look up. |
| candidates | array | Yes | Names to compare with the query. |
| kind | string | No | company strips legal forms, person removes titles and handles "Surname, Given"; auto decides per name. |
| threshold | number | No | Score from which is_match is true. |
| legal_form_countries | array | No | ISO 3166-1 countries whose ELF legal forms are recognised. US entries are per state and include generic words such as Co. and Ltd. |
| top | integer | No | Number of best candidates returned. |
Show full input schema
{
"type": "object",
"additionalProperties": false,
"required": [
"query",
"candidates"
],
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 300,
"description": "Name to look up."
},
"candidates": {
"type": "array",
"minItems": 1,
"maxItems": 1000,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"description": "Names to compare with the query."
},
"kind": {
"type": "string",
"enum": [
"auto",
"company",
"person",
"generic"
],
"default": "auto",
"description": "company strips legal forms, person removes titles and handles \"Surname, Given\"; auto decides per name."
},
"threshold": {
"type": "number",
"minimum": 0,
"maximum": 1,
"default": 0.85,
"description": "Score from which is_match is true."
},
"legal_form_countries": {
"type": "array",
"minItems": 1,
"maxItems": 60,
"items": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"default": [
"DE",
"AT",
"CH"
],
"description": "ISO 3166-1 countries whose ELF legal forms are recognised. US entries are per state and include generic words such as Co. and Ltd."
},
"top": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 10,
"description": "Number of best candidates returned."
}
}
}Published input example
{
"query": "Müller GmbH",
"candidates": [
"Mueller GmbH",
"Möller AG",
"Schmidt GmbH"
]
}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
- Textwerk0.002 USDC
acronym ideas
POSThttps://text.halowerk.com/v1/acronym-ideasSplits the title into words, marks German and English stop words (and, of, für, und ), and enumerates in word order every combination of the first 1-3 letters of each significant word (stop words contribute 0 or 1 letter when allowed), with
- Textwerk0.005 USDC
agg check
POSThttps://text.halowerk.com/v1/agg-checkApplies documented rules to the ad text and its first line or title: explicit age limits and age ranges, youth-related team wording and career-stage target groups (age); native-speaker, accent and origin requirements, nationality (ethnic or
- Textwerk0.002 USDC
anglicism replace
POSThttps://text.halowerk.com/v1/anglicism-replaceLooks up every word in about 1,050 entries that OpenThesaurus (export 2026-10-30, LGPL-2.1 or CC BY-SA 4.0) labels English, Anglicism or Denglisch, matching inflected forms from german-pos-dict 1.2.2 (CC BY-SA 4.0) and English heads of comp