---
title: "Retrieve Emotion Intensity"
method: GET
path: "/v1/videos/{video_id}/frames/{frame_id}/valence_arousal"
tags: ["Video Emotion API"]
---

# Retrieve Emotion Intensity

`GET /v1/videos/{video_id}/frames/{frame_id}/valence_arousal`

## 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/videos/{video_id}/frames/{frame_id}/valence_arousal`
- 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`

Retrieve Emotion Intensity for a Specific Frame

## Path parameters

- `video_id` string, required: The unique video ID of the video for which the frame's valence, arousal, and intensity are to be fetched.
- `frame_id` string, required: The unique frame ID of the frame from which to fetch the valence, arousal, and intensity.

## Query parameters

- `face_id` string, nullable: The ID of the face whose valence, arousal, and intensity are to be retrieved. If not provided, these values for the entire frame will be returned.

## Response `200`

Successful Response

- ValenceArousalIntensity: Model representing emotional intensity values. Attributes: valence (float): Positive or negative emotion scale. arousal (float): Energy or excitement level. intensity (float): Overall emotion strength. circumplex_version (str): Which valence/arousal coordinate table the numbers come from.
  - `valence` number, required
  - `arousal` number, required
  - `intensity` number, required
  - `circumplex_version` string: Name of the valence/arousal coordinate table the numbers were computed with: each emotion label sits at a fixed (valence, arousal) point and a face's values are the score-weighted sum of those points. It reflects the table in use now, not the one in use when the video was analysed, and it changes only when the table does.

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-31** `bd825cd86e8c`: 1 info
  - added the optional property `circumplex_version` 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/v1/videos/:video_id/frames/:frame_id/valence_arousal/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)