# Entity extraction

This API is offered in beta, and is not subject to any SLA or deprecation policy. Changes may be made to this API that break backward compatibility.

![](https://developers.google.com/static/ml-kit/images/language/entity-extraction.gif)

Most apps offer users very little interaction with text beyond the basic
cut/copy/paste operations. Entity extraction improves the user experience inside
your app by understanding text and allowing you to add helpful shortcuts based
on context.

[iOS](https://developers.google.com/ml-kit/language/entity-extraction/ios)
[Android](https://developers.google.com/ml-kit/language/entity-extraction/android)

The entity extraction API allows you to recognize specific entities within
static text and while you're typing. Once an entity is identified, you can
easily enable different actions for the user based on the entity type. Supported
entities included are:

| Entity | Example |
|---|---|
| Address | 350 third street, Cambridge MA |
| Date-Time | 2019/09/29, let's meet tomorrow at 6pm |
| Email address | entity-extraction@google.com |
| Flight Number (IATA flight codes only) | LX37 |
| IBAN | CH52 0483 0000 0000 0000 9 |
| ISBN (version 13 only) | 978-1101904190 |
| Money/Currency (Arabic numerals only) | $12, 25 USD |
| Payment / Credit Cards | 4111 1111 1111 1111 |
| Phone Number | (555) 225-3556 12345 |
| Tracking Number (standardized international formats) | 1Z204E380338943508 |
| URL | www.google.com https://en.wikipedia.org/wiki/Platypus |

This API focuses on precision over recognition. Some instances of a particular
entity might not be detected in favor of ensuring accuracy.

Most entities can be detected across languages and locales. The ability to
detect addresses and phone numbers depends on the selected language. Entity
extraction supports the following languages:

- Arabic
- Portuguese
- English (US, UK)
- Dutch
- French
- German
- Italian
- Japanese
- Korean
- Polish
- Russian
- Chinese (Simplified, Traditional)
- Spanish
- Thai
- Turkish

## Examples

| Input text | Detected entities |
|---|---|
| Meet me at 1600 Amphitheatre Parkway, Mountain View, CA, 94043 Let's organize a meeting to discuss. | Entity 1 type: Address Entity 1 text: "1600 Ampitheatre Parkway, Mountain View, CA 94043" |
| You can contact the test team tomorrow at info@google.com to determine the best timeline. | Entity 1 type: Date-Time Entity 1 text: = "June 24th, 2020" Entity 2 type: Email address Entity 2 text: info@google.com |
| Your order has shipped from Google. To follow the progress of your delivery please use this tracking number: 9612804152073070474837 | Entity type: Tracking number Entity text: "9612804152073070474837" |
| Call the restaurant at 555-555-1234 to pay for dinner. My card number is 4111-1111-1111-1111. | Entity 1 type: Phone number Entity 1 text: "555-555-1234" Entity 2 type: Payment card Entity 2 text: "4111 1111 1111 1111" |