Video Emotion API

Get Video Face Analysis

Changed on Oct 31, 2026

Per-frame gaze, eye, blink, liveness, and lip signals — no frame images.

Same authorization as other video GETs (owner, admin, shared, or sample).

Each frames[] row is one face on one frame. Fields the pipeline did not compute are omitted.

Blink rate is not returned. Count False→True transitions on blink and divide by the face's duration in minutes. The eye-tracking heatmap is not a stored dataset — it is a density view of gaze_yaw × gaze_pitch.

Page with start_frame + length on long videos. length=0 (default) pulls every frame from frames-service, same as GET /v1/videos/{id}/frames.

get/v2/videos/{video_id}/face_analysis

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

video_idstring required

The unique video ID of the video to fetch face analysis from

Query parameters

face_idinteger nullable

Optional face ID to restrict the series to one face

start_frameinteger

First frame number to include (inclusive). Ignored when length is 0.

lengthinteger

Max frames to fetch by frame number. 0 = the whole video. Prefer a bound on long videos.

Response

Successful Response