---
title: "Get Text Emotion Insights"
method: GET
path: "/v1/texts/{text_id}"
tags: ["Text Emotion API"]
---

# Get Text Emotion Insights

`GET /v1/texts/{text_id}`

## Request

- Base URL: `https://api.imentiv.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.imentiv.ai/v1/texts/{text_id}`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://api.imentiv.ai/oauth/authorize`
    - Token URL: `https://api.imentiv.ai/oauth/token` scopes: `media.read`

Retrieves detailed emotion analysis results for a specific uploaded text.
Includes paragraph wise analysis, and supports 28 emotions.

## Path parameters

- `text_id` string, required: The unique ID of the text.

## Response `200`

Successful Response

- FetchTextResponse: Detailed response for a text emotion analysis request. Attributes: title (Optional[str]): Title of the text (available for v2 texts). model_id (str): Model used to process the text. created_at (Any): Timestamp of creation. text (Optional[str]): The input text. user_id (Optional[str]): ID of the user who submitted the text. word_count (Optional[int]): Number of words in the input. segments (Optional[List[Emotions]]): List of emotions per sentence. emotions (Optional[dict]): Overall emotions detected in the text. parent_id (Optional[str]): ID associated with parent audio id if any.
  - `id` string, required
  - `status` string, required
  - `title` string, nullable
  - `model_id` string, nullable
  - `document_type` string, nullable
  - `user_id` string, nullable
  - `word_count` integer, nullable
  - `segments` union[], nullable
    - union
      - Emotions: Model representing detected emotions in a sentence. Attributes: emotions (Optional[Dict[str, float]]): Emotion label -> score. sentence (Optional[str]): The sentence where emotions were detected.
        - `emotions` object, nullable
        - `sentence` string, nullable
      - TranscriptEmotions: Represents emotional data for a transcript segment. Attributes: emotions (Optional[Dict[str, float]]): Emotion label -> score, summing to 1.0. start_time (Optional[int]): Start time of the segment in milliseconds. end_time (Optional[int]): End time of the segment in milliseconds. speaker_id (Optional[int]): ID of the speaker for this segment. name (Optional[str]): Name of the speaker, if available. max_emotion (Dict[str, Union[str, float]]): ``{"label": str, "score": float}``. segment (Optional[str]): The actual text of the transcript segment.
        - `emotions` object, nullable
        - `start_time` integer, nullable
        - `end_time` integer, nullable
        - `speaker_id` integer, nullable
        - `name` string, nullable
        - `max_emotion` object
        - `segment` string, nullable
        - `language` string, nullable: Line language; omitted for the audio's main language.
        - `language_source` 'user' | 'detected', nullable: Whether a user range or automatic detection chose the line language.
        - `range_id` string, nullable: User range provenance; absent on detected lines.
  - `created_at` string, nullable
  - `text` string, nullable
  - `emotions` object, nullable
  - `parent_id` string, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-31** `bd825cd86e8c`: 3 info
  - added the optional property `segments/anyOf[subschema #1]/items/anyOf[subschema #2: TranscriptEmotions]/language` to the response with the `200` status
  - added the optional property `segments/anyOf[subschema #1]/items/anyOf[subschema #2: TranscriptEmotions]/language_source` to the response with the `200` status
  - added the optional property `segments/anyOf[subschema #1]/items/anyOf[subschema #2: TranscriptEmotions]/range_id` to the response with the `200` status
- **2026-09-22** `536bf48bb9fb`: 3 info
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - the endpoint scheme security `BearerAuth` was added to the API
  - the endpoint scheme security `OAuth2Delegated` was added to the API
- …earlier changes not shown

[Operation history](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai/changes/v1/texts/:text_id/get.md)

---

[API](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai.md) - [All operations](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai/llms.txt) - [OpenAPI document](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai/revisions/bc15cec7e794?raw)