---
title: "Get Valence Arousal"
method: GET
path: "/v1/videos/{video_id}/valence_arousal"
tags: ["Video Emotion API"]
---

# Get Valence Arousal

`GET /v1/videos/{video_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}/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`

Get emotion intensities of a video based on video_id.

`valence` and `arousal` are the averages over all faces in all frames (or over one face's frames
when `face_id` is given); `intensity` is the length of that averaged (valence, arousal) vector.
`circumplex_version` names the coordinate table the numbers come from.

## Path parameters

- `video_id` string, required: The unique video ID of the video whose emotion intensity is to be fetched

## Query parameters

- `face_id` integer, nullable: Restrict the result to this face: the average is taken over the frames the face appears in. Omit it (or pass 0) to average over every face. Responds 404 if the video has no such face or the face appears in no frame.

## 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`: 2 info
  - added the new optional `query` request parameter `face_id`
  - 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/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/9c4d258def38?raw)