We are currently building something exciting and will be launching soon. Registration is temporarily closed. Launching soon — registration temporarily closed.

EMOTION GROUPS REFERENCE

Emotion Analysis Emotion Groups

Emotion Analysis organizes detection into 20 emotion groups covering 20 emotions across 16 languages.

All Emotions Features
20
Emotion Groups
20
Emotions
16
Languages
Overview Emotion Groups Emotions Features Landing

All Emotion Groups

Each emotion group contains a set of specific emotions that the API can detect. Click a group to expand its signal list. Signal lists are available to customers - sign in to view them.

01

Joy

joy
1

1 signals - request access for the complete list.

View 1 emotions

The complete signal list is available to customers. Request access to view it.

02

Sadness

sadness
1

1 signals - request access for the complete list.

View 1 emotions

The complete signal list is available to customers. Request access to view it.

03

Anger

anger
1

1 signals - request access for the complete list.

View 1 emotions

The complete signal list is available to customers. Request access to view it.

04

Fear

fear
1

1 signals - request access for the complete list.

View 1 emotions

The complete signal list is available to customers. Request access to view it.

05

Surprise

surprise
1

1 signals - request access for the complete list.

View 1 emotions

The complete signal list is available to customers. Request access to view it.

06

Disgust

disgust
1

1 signals - request access for the complete list.

View 1 emotions

The complete signal list is available to customers. Request access to view it.

07

Love

love
1

1 signals - request access for the complete list.

View 1 emotions

The complete signal list is available to customers. Request access to view it.

08

Pride

pride
1

1 signals - request access for the complete list.

View 1 emotions

The complete signal list is available to customers. Request access to view it.

09

Shame

shame
1

1 signals - request access for the complete list.

View 1 emotions

The complete signal list is available to customers. Request access to view it.

10

Hope

hope
1

1 signals - request access for the complete list.

View 1 emotions

The complete signal list is available to customers. Request access to view it.

Reading Emotion Analysis output

What you can safely infer from a result - and what you must not.

Intended task

Rank which of the 20 documented emotions a piece of text expresses - the emotional register of the writing.

Input requirements

  • text - the only field analyzed; up to 4,096 Unicode code points. Over the limit is rejected with input_too_long, never truncated.
  • language - must be a language this analyzer supports. Unsupported codes are rejected with 400 unsupported_language, never analyzed as a different language.
  • analyzers - include "emotions"; up to 2 analyzers per request, one billed run each.
  • No context beyond text - no user IDs, history, profiles, or attachments are read or inferred.
  • Short text works, but single words and fragments carry little signal - very thin input can return an empty result.

Ordinary positive

“I was dreading this release all week, but seeing it finally live - I am honestly so proud of the team.”

pride very high
relief high
excitement medium

Safe inference: The text expresses pride and relief with an excitement undertone - a ranked mix, not a single verdict.

Confusing negative · Reported speech

“The customer sounded angry. You must be furious about the delay.”

What happens: Anger signals can fire - the text describes and attributes emotion rather than expressing it. Signals reflect the emotional language in the text, which may belong to a described third party rather than the author.

Why it's tricky: Secondhand emotion, quoted feelings, and hypothetical phrasing ("you must be furious") share vocabulary with felt emotion. Read emotion signals as the register of the text, not a measurement of any person's actual state.

What you can safely infer

  • The emotional register of the text as written, ranked across the documented emotion set.
  • That mixed emotions are a normal result - consume the ranked list, not just the top label.

What you must not infer

  • ✕The author's actual mental or emotional state - text is evidence of language, not feeling.
  • ✕That a described emotion belongs to the author rather than someone they describe.
  • ✕That a flat or empty result means the author feels nothing - thin text is thin evidence.

Boundary: Emotion signals describe the emotional language in a text. They are not a mental-health assessment and say nothing about any person's actual state.

Signal reference Evaluation evidence Understanding signals API reference Evaluate on your data

Access the taxonomy through the API

Check Emotion Analysis availability and endpoint programmatically via the public catalog endpoint - no authentication required. Include your API key to also retrieve taxonomy size and supported languages.

curl -X GET https://sentiqra.tech/v1/meta/domains/emotions \
  -H "Authorization: Bearer sq_live_your_key_here"

Example response (authenticated):

{
    "catalog_version": "...",
    "domain": {
        "id": "emotions",
        "name": "Emotion Analysis",
        "status": "production",
        "taxonomy": { "groups": 20, "detection_labels": 20 },
        "languages": [ ... ]
    }
}

Signals returned by the analyzers use code for the category or label slug - these correspond to the categories and emotions documented on this page.

Back to Emotion Analysis Docs View all 20 Emotions

Quickstart Guide

First API call in under 5 minutes

API Reference

Full endpoint documentation

Playground

Test detection live - no API key

Indicator Dictionary

Browse all 20 emotions