Text Emotion API

Get Text Details

Changed on

Retrieve all details for a specific text directly from the database.

Returns a complete standardized response with all possible fields. Fields that don't exist in the database are returned as null.

Access Control:

  • Authenticated users can access their own texts
  • Admins can access all texts
  • Sample texts and shared texts are publicly accessible
get/v2/texts/{text_id}

Request

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

Path parameters

text_idstring required

The unique ID of the text.

Response

Successful Response

bulk_upload_idstring nullable

Bulk upload batch ID

created_atstring nullable

Creation timestamp

updated_atstring nullable

ISO-8601 UTC timestamp of the last change to this text. Compare it for inequality with the value you hold to tell whether your copy is stale; it carries no ordering guarantee. It covers this text's own fields only, not data derived from other records such as frames or analytics.

csv_analysis_urlstring nullable

CSV analysis file URL

csv_statusstring nullable

CSV generation status

document_typestring nullable

Document type: standalone, transcript

idstring nullable

Unique text identifier

is_userboolean nullable

Whether user submitted text

media_sourcestring nullable

Cloud platform source: dropbox, google_drive, aws_s3, public_url

media_source_urlstring nullable

Original cloud storage URL

model_idstring nullable

Model used for processing

urlstring nullable

GCS bucket URL of uploaded extracted text

parent_idstring nullable

Parent audio/video ID if transcript

predefined_qaobject[] nullable

Predefined Q&A about the text

psychologist_reviewstring nullable

Psychologist review content

psychologist_review_statusstring nullable

Psychologist review status

sentencesobject[] nullable

Sentences with emotions

share_statusboolean nullable

Whether text is shared

statusstring nullable

Processing status

tags_mapobject nullable

Tags map with general and sample flags

textstring nullable

The actual text content (may contain HTML)

text_emotionsobject nullable

Overall text emotions

titlestring nullable

Text title

ui_requestboolean nullable

Whether request came from UI

user_idstring nullable

The user who created the item (the same value as created_by).

created_bystring nullable

The user who created the item. Never changes, including when the item is moved to a workspace.

word_countinteger nullable

Word count

youtube_urlstring nullable

YouTube URL if applicable

Example response

{
  "updated_at": "2025-12-01T14:30:00.000000+00:00"
}

Changes

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status