Text Analytics

Microsoft Cognitive Services Text Analytics detects language, sentiment and more of the text you provide.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure China regions
Flow Standard All Flow regions
PowerApps Standard All PowerApps regions

To use this integration, you will need access to a Cognitive Services Text Analytics Account or API Key. To make a connection, provide the account or API key and select Create connection. When using the connection, the operations you do will count towards the quota set on your Cognitive Services key. When that quota is exceeded you may see errors in the connector, or your Cognitive Services account may be charged for additional requests, depending how your account is configured.

You're now ready to start using this integration.

Creating a connection

To connect your account, you will need the following information:

Name Type Description
Account Key securestring

Cognitive Services Account Key

Site URL string

Root site url (Example: https://westus.api.cognitive.microsoft.com). If not specified, site url will be defaulted to https://westus.api.cognitive.microsoft.com.

Throttling Limits

Name Calls Renewal Period
API calls per connection120060 seconds

Actions

Detect Language

Returns the detected language and a numeric score between 0 and 1. Scores close to 1 indicate 100% certainty that the identified language is true. A total of 120 languages are supported.

Detect Language [DEPRECATED]

Returns the detected language and a numeric score between 0 and 1. Scores close to 1 indicate 100% certainty that the identified language is true. A total of 120 languages are supported.

Detect Sentiment

Returns a numeric score between 0 and 1. Scores close to 1 indicate positive sentiment, while scores close to 0 indicate negative sentiment.

Detect Sentiment [DEPRECATED]

Returns a numeric score between 0 and 1. Scores close to 1 indicate positive sentiment, while scores close to 0 indicate negative sentiment. Currently, the following languages are supported: English, Spanish, French, Portuguese.

Entities

Returns a list of known entities and general named entities ("Person", "Location", "Organization" etc) in a given document.

Key Phrases

Returns a list of strings denoting the key talking points in the input text.

Key Phrases [DEPRECATED]

Returns a list of strings denoting the key talking points in the input text. Currently, the following languages are supported: English, German, Spanish and Japanese.

Detect Language

Returns the detected language and a numeric score between 0 and 1. Scores close to 1 indicate 100% certainty that the identified language is true. A total of 120 languages are supported.

Parameters

Name Key Required Type Description
Text
text string

The text to analyze.

Returns

Detect Language [DEPRECATED]

Returns the detected language and a numeric score between 0 and 1. Scores close to 1 indicate 100% certainty that the identified language is true. A total of 120 languages are supported.

Parameters

Name Key Required Type Description
Text
text string

The text to analyze.

Number of languages
numberOfLanguagesToDetect integer

The number of languages to detect. Set to 1 by default.

Returns

Detect Sentiment

Returns a numeric score between 0 and 1. Scores close to 1 indicate positive sentiment, while scores close to 0 indicate negative sentiment.

Parameters

Name Key Required Type Description
Text
text string

The text to analyze.

Language
language string

This is the 2 letter ISO 639-1 representation of a language.

        For example, use "en" for English; "es" for Spanish etc.,

Returns

Detect Sentiment [DEPRECATED]

Returns a numeric score between 0 and 1. Scores close to 1 indicate positive sentiment, while scores close to 0 indicate negative sentiment. Currently, the following languages are supported: English, Spanish, French, Portuguese.

Parameters

Name Key Required Type Description
Text
text string

The text to analyze.

Language
language string

This is the 2 letter ISO 639-1 representation of a language.

        For example, use "en" for English; "es" for Spanish etc.,

Returns

Entities

Returns a list of known entities and general named entities ("Person", "Location", "Organization" etc) in a given document.

Parameters

Name Key Required Type Description
Text
text string

The text to analyze.

Language
language string

This is the 2 letter ISO 639-1 representation of a language.

        For example, use "en" for English; "es" for Spanish etc.,

Returns

Key Phrases

Returns a list of strings denoting the key talking points in the input text.

Parameters

Name Key Required Type Description
Text
text string

The text to analyze.

Language
language string

This is the 2 letter ISO 639-1 representation of a language.

        For example, use "en" for English; "es" for Spanish etc.,

Returns

Key Phrases [DEPRECATED]

Returns a list of strings denoting the key talking points in the input text. Currently, the following languages are supported: English, German, Spanish and Japanese.

Parameters

Name Key Required Type Description
Text
text string

The text to analyze.

Language
language string

This is the 2 letter ISO 639-1 representation of a language.

        For example, use "en" for English; "es" for Spanish etc.,

Returns

Definitions

KeyPhraseResult

Name Path Type Description
Key Phrases
keyPhrases array of string

A list of representative words or phrases. The number of key phrases returned is proportional to the number of words in the input document.

Id
id string

The unique document identifier.

EntitiesResult

Name Path Type Description
Entities
entities array of object

A list of disambiguated entities with links to more information on the web (Wikipedia and Bing).

Name
entities.name string

Name of the entity.

Matches
entities.matches array of object

A list of matches for the entity.

items
entities.matches object
Wikipedia Language
entities.wikipediaLanguage string

Wikipedia language of the entity.

Wikipedia Id
entities.wikipediaId string

Wikipedia Id of the entity.

Wikipedia Url
entities.wikipediaUrl string

Wikipedia url of the entity.

Bing Id
entities.bingId string

Bing Id of the entity.

Type
entities.type string

Type of the entity.

Subtype
entities.subType string

Subtype of the entity.

Id
id string

The unique document identifier.

LanguageResult

Name Path Type Description
Id
id string

The unique document identifier.

detectedLanguages
detectedLanguages array of DetectedLanguageV2

A list of extracted languages.

DetectedLanguageV2

Name Path Type Description
Name
name string

The long name of a detected language (e.g. English, French).

Language Code
iso6391Name string

A two letter representation of the detected language according to the ISO 639-1 standard (e.g. en, fr).

Score
score double

A confidence score between 0 and 1. Scores close to 1 indicate 100% certainty that the identified language is true.

SentimentResult

Name Path Type Description
Score
score double

A decimal number between 0 and 1 denoting the sentiment of the document. A score above 0.7 usually refers to a positive document while a score below 0.3 normally has a negative connotation. Mid values refer to neutral text.

Id
id string

The unique document identifier.