Supported entity categories in the Text Analytics API v3

Use this article to find the entity categories that can be returned by Named Entity Recognition (NER). NER runs a predictive model to identify and categorize named entities from an input document.

NER v3.1 is also available, which includes the ability to detect personal (PII) and health (PHI) information. Additionally, click on the Health tab to see a list of supported categories in Text Analytics for health.

You can find a list of types returned by version 2.1 in the migration guide

Entity categories

The NER feature for Text Analytics returns the following general (non identifying) entity categories. for example when sending requests to the /entities/recognition/general endpoint.

Category Description
Person Names of people.
PersonType Job types or roles held by a person.
Location Natural and human-made landmarks, structures, geographical features, and geopolitical entities
Organization Companies, political groups, musical bands, sport clubs, government bodies, and public organizations.
Event Historical, social, and naturally occurring events.
Product Physical objects of various categories.
Skill A capability, skill, or expertise.
Address Full mailing addresses.
Phone number Phone numbers.
Email Email addresses.
URL URLs to websites.
IPAddress Network IP addresses.
DateTime Dates and times of day.
Quantity Numerical measurements and units.

Category: Person

This category contains the following entity:

Entity

Person

Details

Names of people.

Supported document languages

ar, cs, da, nl, en, fi, fr, de, he,
hu, it, ja, ko, no, pl, pt-br, pt-pt, ru, es, sv, tr

Category: PersonType

This category contains the following entity:

Entity

PersonType

Details

Job types or roles held by a person

Supported document languages

en, es, fr, de, it, zh-hans, ja, ko, pt-pt, pt-br

Category: Location

This category contains the following entity:

Entity

Location

Details

Natural and human-made landmarks, structures, geographical features, and geopolitical entities.

Supported document languages

ar, cs, da, nl, en, fi, fr, de, he, hu, it, ja, ko, no, pl, pt-br, pt-pt, ru, es, sv, tr

Subcategories

The entity in this category can have the following subcategories.

Entity subcategory

Geopolitical Entity (GPE)

Details

Cities, countries/regions, states.

Supported document languages

en, es, fr, de, it, zh-hans, ja, ko, pt-pt, pt-br

Structural

Manmade structures.

en

Geographical

Geographic and natural features such as rivers, oceans, and deserts.

en

Category: Organization

This category contains the following entity:

Entity

Organization

Details

Companies, political groups, musical bands, sport clubs, government bodies, and public organizations. Nationalities and religions are not included in this entity type.

Supported document languages

ar, cs, da, nl, en, fi, fr, de, he, hu, it, ja, ko, no, pl, pt-br, pt-pt, ru, es, sv, tr

Subcategories

The entity in this category can have the following subcategories.

Entity subcategory

Medical

Details

Medical companies and groups.

Supported document languages

en

Stock exchange

Stock exchange groups.

en

Sports

Sports-related organizations.

en

Category: Event

This category contains the following entity:

Entity

Event

Details

Historical, social, and naturally occurring events.

Supported document languages

en, es, fr, de, it, zh-hans, ja, ko, pt-pt and pt-br

Subcategories

The entity in this category can have the following subcategories.

Entity subcategory

Cultural

Details

Cultural events and holidays.

Supported document languages

en

Natural

Naturally occurring events.

en

Sports

Sporting events.

en

Category: Product

This category contains the following entity:

Entity

Product

Details

Physical objects of various categories.

Supported document languages

en, es, fr, de, it, zh-hans, ja, ko, pt-pt, pt-br

Subcategories

The entity in this category can have the following subcategories.

Entity subcategory

Computing products

Details

Computing products.

Supported document languages

en

Category: Skill

This category contains the following entity:

Entity

Skill

Details

A capability, skill, or expertise.

Supported document languages

en , es, fr, de, it, pt-pt, pt-br

Category: Address

This category contains the following entity:

Entity

Address

Details

Full mailing address.

Supported document languages

en, es, fr, de, it, zh-hans, ja, ko, pt-pt, pt-br

Category: PhoneNumber

This category contains the following entity:

Entity

PhoneNumber

Details

Phone numbers (US and EU phone numbers only).

Supported document languages

en, es, fr, de, it, zh-hans, ja, ko, pt-pt pt-br

Category: Email

This category contains the following entity:

Entity

Email

Details

Email addresses.

Supported document languages

en, es, fr, de, it, zh-hans, ja, ko, pt-pt, pt-br

Category: URL

This category contains the following entity:

Entity

URL

Details

URLs to websites.

Supported document languages

en, es, fr, de, it, zh-hans, ja, ko, pt-pt, pt-br

Category: IPAddress

This category contains the following entity:

Entity

IPAddress

Details

network IP addresses.

Supported document languages

en, es, fr, de, it, zh-hans, ja, ko, pt-pt, pt-br

Category: DateTime

This category contains the following entities:

Entity

DateTime

Details

Dates and times of day.

Supported document languages

en, es, fr, de, it, zh-hans, ja, ko, pt-pt, pt-br

Entities in this category can have the following subcategories

Subcategories

The entity in this category can have the following subcategories.

Entity subcategory

Date

Details

Calender dates.

Supported document languages

en, es, fr, de, it, zh-hans, pt-pt, pt-br

Time

Times of day.

en, es, fr, de, it, zh-hans, pt-pt, pt-br

DateRange

Date ranges.

en, es, fr, de, it, zh-hans, pt-pt, pt-br

TimeRange

Time ranges.

en, es, fr, de, it, zh-hans, pt-pt, pt-br

Duration

Durations.

en, es, fr, de, it, zh-hans, pt-pt, pt-br

Set

Set, repeated times.

en, es, fr, de, it, zh-hans, pt-pt, pt-br

Category: Quantity

This category contains the following entities:

Entity

Quantity

Details

Numbers and numeric quantities.

Supported document languages

en, es, fr, de, it, zh-hans, ja, ko, pt-pt, pt-br

Subcategories

The entity in this category can have the following subcategories.

Entity subcategory

Number

Details

Numbers.

Supported document languages

en, es, fr, de, it, zh-hans, pt-pt, pt-br

Percentage

Percentages

en, es, fr, de, it, zh-hans, pt-pt, pt-br

Ordinal numbers

Ordinal numbers.

en, es, fr, de, it, zh-hans, pt-pt, pt-br

Age

Ages.

en, es, fr, de, it, zh-hans, pt-pt, pt-br

Currency

Currencies

en, es, fr, de, it, zh-hans, pt-pt, pt-br

Dimensions

Dimensions and measurements.

en, es, fr, de, it, zh-hans, pt-pt, pt-br

Temperature

Temperatures.

en, es, fr, de, it, zh-hans, pt-pt, pt-br

Next steps