Entity matchers overview

Entity matchers are used to find various data in text. For example, you can use them to find dates, numbers, emails, and so on. This enables you to:

• Detect if a text contains certain data
• Extract structured data from unstructured text
• Mask out swear words, phone numbers, and other sensitive data
• Pseudonymize data for GDPR compliance

​

Masking

You can use entity matchers to mask out certain words or phrases. For example, you can mask out swear words, phone numbers, or other sensitive data. You can enable masking and set the replacement value when you add a matcher to your project.

When masking is enabled the content field of the text moderation response will the modified text, the original field will contain the original text. The content_moderated field will indicate whether the content differs from the original text.

{
  // ...
  "content_moderated": true,
  "data_found": true,
  "flagged": true,
  "original": "You can contact me on mr_robot[at]gmail|DOT|com or call me on 12 34 65 78",
  "content": "You can contact me on {{ email hidden }} or call me on {{ number hidden }}",
  "email": {
    "found": true,
    "mode": "SUSPICIOUS",
    "matches": ["mr_robot[at]gmail|DOT|com"]
  },
  "phone": {
    "found": true,
    "mode": "NORMAL",
    "matches": ["12 34 65 78"]
  }
}

​

Detection levels

For most matchers you can set the detection level. This determines how strict the matcher should be.

​

Response signature

All matcher models have the same response signature:

​

Pre-built entity matchers