Get Video Face Analysis
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.
Path parameters
The unique video ID of the video to fetch face analysis from
The unique video ID of the video to fetch face analysis from
Query parameters
Optional face ID to restrict the series to one face
Optional face ID to restrict the series to one face
First frame number to include (inclusive). Ignored when length is 0.
First frame number to include (inclusive). Ignored when length is 0.
Max frames to fetch by frame number. 0 = the whole video. Prefer a bound on long videos.
Max frames to fetch by frame number. 0 = the whole video. Prefer a bound on long videos.
Response
Successful Response