---
id: "emotion"
kind: "datatype"
status: "draft"
is_pii: false
name: "Emotion (category)"
categories: ["texts"]
langs: ["en"]
quality: 65
url: "https://registry.apicrafter.io/datatype/emotion"
---

# Emotion (category) (`emotion`)

> **Draft.** Draft records have not been reviewed yet and may be incomplete or wrong; do not treat them as authoritative for legal or compliance decisions.

Emotion that a text, a voice recording or a face expresses, as emotion classifiers and lexicons label it: the six basic emotions of Paul Ekman (anger, disgust, fear, happiness, sadness, surprise), the eight primary emotions of the wheel of Robert Plutchik (joy, trust, fear, surprise, sadness, disgust, anger, anticipation), which the NRC Emotion Lexicon uses, and often a neutral class. Tables of tweets, reviews and survey answers count or average them. The polarity of a text (positive, negative, neutral) is sentiment.

- Parent datatype: [`category`](https://registry.apicrafter.io/datatype/category.md)
- Personal data (PII): no
- Categories: Texts and articles (texts)
- Countries: global
- Languages: English (en)
- Classification: categorical

## Examples

- `anger`
- `joy`
- `sadness`
- `anticipation` — one of the eight emotions of Plutchik
- `surprise`

## Metacrafter rules

2 rules: 1 match the field name, 1 match values.

- `emotionbyname` (field, `common/analytics.yaml`)
- `emotionvalue` (data, `common/analytics.yaml`)

## Supported by tools

- [`metacrafter`](https://registry.apicrafter.io/tool/metacrafter.md)

## Translations

- ru: Эмоция (категория)

## Sources

- wikipedia: <https://en.wikipedia.org/wiki/Emotion_classification>

## Quality

Score 65/100. Missing: regexp, negative example, mapping (Wikidata, Schema.org, ...).

JSON: <https://registry.apicrafter.io/api/v1/datatypes/emotion.json> · Edit: <https://github.com/apicrafter/metacrafter-registry/edit/main/data/datatypes/any/texts/emotion.yaml>
