---
title: "Get Video Multimodal Insights"
method: GET
path: "/v2/videos/{video_id}/multimodal-analytics"
tags: ["Video Emotion API"]
---

# Get Video Multimodal Insights

`GET /v2/videos/{video_id}/multimodal-analytics`

## 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/v2/videos/{video_id}/multimodal-analytics`
- 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`

Get complete multimodal analytics for a video including:
- Video emotion analysis (face-by-face)
- Audio emotion analysis (speaker-by-speaker)
- Text sentiment analysis
- Detected faces and speakers
- Overall summaries

## Path parameters

- `video_id` string, required: The unique ID of the video

## Response `200`

Successful Response

- FullVideoAnalyticsResponse: Complete multimodal analytics response for video content.
  - `title` string
  - `status` string
  - `description` string
  - `created_at` string
  - `updated_at` string, nullable: ISO-8601 UTC timestamp of the latest change to any of the records this response is built from (the video, its audio and its transcript). Compare it for inequality with the value you hold; it carries no ordering guarantee. It does not cover the emotion analysis computed from frames and faces, which can change without any of those records changing.
  - `media_type` string
  - `video_id` string
  - `audio_id` string
  - `text_id` string
  - `duration` number
  - `total_frames_count` integer
  - `frame_rate` number, nullable
  - `frame_height` number, nullable
  - `frame_width` number, nullable
  - `face_count` integer
  - `speaker_count` integer
  - `media_source_url` string
  - `annotated_video_url` string
  - `youtube_url` string, nullable
  - `detected_faces` object[]
  - `detected_speakers` object[]
  - `emotion_analysis` EmotionAnalysis, required: Hierarchical emotion analysis structure.
    - `overall` OverallEmotions, required: Overall emotions across modalities.
      - `video` object, nullable
      - `audio` object
      - `text` object
    - `faces` object, nullable
    - `speakers` object

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-31** `bd825cd86e8c`: 1 info
  - added the optional property `updated_at` 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

[Operation history](https://skmtc.dev/imentiv/apis/welcome-to-imentiv-ai/changes/v2/videos/:video_id/multimodal-analytics/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)