Text Emotion API

Analyze emotions and sentiment from text content.

Submit text directly, provide a cloud storage URL, or upload a text file (.txt, .srt, .pdf).

Input Modes (provide exactly one):

  • text: Raw text content for direct analysis
  • text_url: URL to a text file from Dropbox, Google Drive, AWS S3, or any public URL
  • text_file: Direct file upload (.txt, .srt, .pdf)

How It Works:

  1. Submit your text (or file URL / file upload) and receive an immediate response with a text ID
  2. For file URLs/uploads: the file is downloaded/read, text extracted, and word count calculated
  3. Text is queued for processing (typically completes within seconds)
  4. Optionally receive a webhook notification via callback_url when complete
  5. Retrieve results using the text ID

Supported File Formats (for text_url and text_file):

  • .txt — Plain text files
  • .srt — Subtitle files (timestamps are stripped, only text is extracted)
  • .pdf — PDF documents (text extracted from all pages)

Credit Usage: Billed on success; the amount is recorded after the run and is not quoted on this request. Each text analysis is billed at least 2 credits. A 402 is returned before processing starts when admission is refused.

post/v2/texts

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.write

Request body multipart/form-data

titlestring nullable

A descriptive title for your text (e.g., 'Customer Feedback' or 'Meeting Notes').

textstring nullable

The raw text content to be analyzed for emotions. Provide exactly one of 'text', 'text_url', or 'text_file'.

text_urlstring nullable

Cloud storage URL to a text file (.txt, .srt, .pdf). Supported: Dropbox, Google Drive, AWS S3, or direct public URLs. Provide exactly one of 'text', 'text_url', or 'text_file'.

text_filestring binary

Upload a text file (.txt, .srt, .pdf) directly. Provide exactly one of 'text', 'text_url', or 'text_file'.

callback_urlstring

Your webhook URL to receive a notification when analysis completes. Must be an https URL on a publicly reachable host.

Response

Successful Response

idstring required
titlestring required
statusstring required
word_countinteger required
user_idstring required
created_atstring nullable
media_sourcestring nullable
media_source_urlstring nullable

Changes

    • info

      the endpoint scheme security ApiKeyAuth was added to the API

    • info

      the endpoint scheme security BearerAuth was added to the API

    • info

      the endpoint scheme security OAuth2Delegated was added to the API

    • info

      the request property type was generalized from no type to string, and format from no format to binary