v1

latestOpenAPI 3.1.02026-07-1381127211.1 KB
Video Emotion API

Upload Video

Analyze emotions and facial expressions from video content.

Submit a video from multiple sources and receive detailed emotion analysis of all detected faces throughout the video timeline.

Input Sources:

  • YouTube: Provide any YouTube video URL
  • Cloud Storage: Dropbox, Google Drive, or other cloud service links
  • Social Media: Instagram, Facebook, Twitter (X) videos
  • Direct URL: Any publicly accessible video link
  • File Upload: Upload video files directly from your device

Analyze Specific Segments: Focus on specific portions using start_millis and end_millis parameters. This helps target key moments and optimize credit usage.

How It Works:

  1. Submit your video and receive an immediate response with a video ID
  2. Video is queued for processing (typically completes within minutes)
  3. Optionally receive a webhook notification via callback_url when complete
  4. Retrieve results using the video ID

Supported Formats: MP4, AVI, MOV, WebM, MPEG

Credit Usage: Processing is billed at 1 credit per second of analyzed video duration. Professional and Enterprise plans: 0.5 credits per second.

post/v2/videos

Response

Successful Response

idstring required
titlestring required
statusstring required
durationinteger required
media_sourcestring required
media_source_urlstring required
user_idstring required
created_atstring nullable
processing_fpsinteger nullable
All 81 operations