Skip to main content

Get Average Emotions

GET 
/v2/videos/:video_id/emotions/average

Calculate and retrieve average emotion scores for a video with optional face filtering.

This endpoint computes the average emotion percentages across all frames in a video. When a face_id is provided, it calculates the average emotions for only that specific face.

Behavior:

  • Without face_id: Returns overall average emotion score for entire video (all faces combined)
  • With face_id: Calculates average emotion scores for the specified face

Parameters:

  • video_id: Unique identifier for the video
  • face_id: (Optional) Calculate average emotions for only this face ID

Response: Returns emotion scores as percentages (values sum to 1.0):

  • angry: Percentage of anger emotion
  • disgust: Percentage of disgust emotion
  • fear: Percentage of fear emotion
  • happy: Percentage of happiness emotion
  • sad: Percentage of sadness emotion
  • surprise: Percentage of surprise emotion
  • neutral: Percentage of neutral emotion

Use Cases:

  • Overall video analysis: Understand the general emotional tone of the entire video
  • Individual tracking: Track emotional patterns of specific people throughout the video
  • Comparative analysis: Compare emotional profiles between different faces in the same video

Example Usage:

  • Overall average: GET /v2/videos/123/emotions/average
  • Face-specific: GET /v2/videos/123/emotions/average?face_id=1

Note: Face-specific calculations require the face to appear in at least one frame.

Request​

Responses​

Successful Response