Tisane can break down full names into key components:
| Attribute | Description |
|---|---|
given_name | First name (e.g., John) |
middle_name | Middle name (if applicable) |
surname | Last name (e.g., Doe) |
title | Honorifics (e.g., Dr., Mr., Ms.) |
suffix | Name suffix (e.g., Jr., Sr., III) |
social_role | Roles like Haji or Dr. |
To parse a full name, send a POST /parse request with:
"entity": "person""words": true
The response will categorize the name components under the role attribute.
Example of Name Parsing: 
While Tisane cannot verify if a user’s provided name is real, it recognizes many names associated with:
- Famous figures (
important_person) - Fictional characters (
fictional_character) - Spiritual beings (
spiritual_being) - Names that don’t appear to be names (for example: User-13789026152908425434)
For a list of common fake names, refer to this Quora post.
The subtype attribute in the entity structure indicates the type of name detected, with a Wikidata ID if available.
Example of Fictional Character Name Parsing:
The /compare/entities method allows comparing two names (even across languages) and detecting differences.
| Name 1 | Name 2 | Result |
|---|---|---|
| William Smith | Will Smith | {"result":"different","differences":["variation"]} |
| Musa Bin Osman | Haji Musa Bin Osman | {"result":"different","differences":["social_role"]} |
| William Smith | Вилл Смит (Will Smith in Russian) | {"result":"different","differences":["variation"]} |
| Kevin Tan | TAN Kevin | {"result":"same"} |
Send a request to the /compare/entities endpoint with the names to compare, and the response will return differences in attributes like:
variation(e.g., William vs Will)social_role(e.g., Haji Musa vs Musa)case_difference(e.g., John Doe vs JOHN DOE)same(Identical names, even if the order differs)
Usernames and aliases can be misleading, offensive, or abusive. Tisane detects inappropriate usernames (e.g., Hitler, UserJohn_is_liar).
Send a send a POST /parse request with:
"format": "alias"The
subscopesetting ensures names are properly segmented, even if written in camel case, with underscores, or without spaces.
Example of nickname vetting:
