# Text Sentiment

## Overview

Text Sentiment is one of the intelligence services of the Filestack platform. You can detect general emotions of text.

## Processing API

Text Sentiment is available as a synchronous operation in the Processing API using the following task:

`text_sentiment`

To use this task in Processing API, you have to use security policy and signature. Read more about security policies [here](https://www.filestack.com/docs/security/policies/).

| PARAMETER | VALUE | OPTIONS | DESCRIPTION |
| --- | --- | --- | --- |
| **text\*** | string |  | Text for analysis. |
| **language** | stringauto | `auto`, `en`, `es`, `fr`, `de`, `it`, `pt`, `ar`, `hi`, `ja`, `ko`, `zh`, `zh-TW` | When `auto` value is used we will try to detect the language of the text automatically. |

### Response

```
https://cdn.filestackcontent.com/security=p:<POLICY>,s:<SIGNATURE>/text_sentiment=text:"this product is outstanding"
```

```
{
    "emotions": {
        "Positive": 0.9997168183326721,
        "Negative": 0.0000452575332019,
        "Neutral": 0.0001435235462849,
        "Mixed": 0.0000943295744946
    }
}
```

### Response Parameters

|     |     |     |
| --- | --- | --- |
| **emotions** | [dictionary](https://www.filestack.com/docs/transformations/intelligence/text-sentiment/#color-options) | Contains detected emotions |

### Examples

- Get the sentiment information of text:

```
https://cdn.filestackcontent.com/security=p:<POLICY>,s:<SIGNATURE>/text_sentiment=text:"quick brown fox"
```

## Webhook

Below you can find an example webhook payload for text sentiment task

```
{
    "id": 65374401,
    "action": "fs.workflow",
    "timestamp": 1551126197,
    "text": {
        "workflow": "c516549f-3755-4fb5-85a4-15ae4b31d475",
        "createdAt": "2020-01-25T20:21:53.929686791Z",
        "updatedAt": "2020-01-25T20:21:56.716186597Z",
        "sources": [
            "H2swKXwhRxKFrylakLwcd"
        ],
        "results": {
            "text_sentiment_1551120182170": {
                "data": {
                    "emotions": {
                        "Mixed": 0.027882017195224762,
                        "Negative": 0.02189556509256363,
                        "Neutral": 0.7253097891807556,
                        "Positive": 0.22491265833377838
                    }
                }
            }
        },
        "status": "Finished"
    }
}
```

Please visit the [webhooks](https://www.filestack.com/docs/api/webhooks/#workflow) documentation page to learn more.