v1

latestOpenAPI 3.1.02026-07-1381127211.1 KB

Video Emotion API

Get Video Details

Retrieve all details for a specific video directly from the database.

Returns a complete standardized response with all possible fields. Fields that don't exist in the database are returned as null.

Access Control:

Authenticated users can access their own videos
Admins can access all videos
Sample videos and shared videos are publicly accessible

get/v2/videos/{video_id}

Path parameters

video_idstring required

The unique ID of the video.

Response

Successful Response

annotated_videostring nullable

Annotated video URL

annotated_video_mp4string nullable

Annotated video MP4 URL

annotated_video_percentagestring nullable

Annotated video progress

annotated_video_statusstring nullable

Annotated video status

audio_csv_urlstring nullable

Audio-specific CSV analysis URL

audio_idstring nullable

Associated audio analysis ID

audio_transcriptionstring nullable

Audio transcription text

bulk_upload_idstring nullable

Bulk upload batch ID

check_audioboolean nullable

Whether audio should be checked

completed_atstring nullable

Completion timestamp

compressed_frames_data_urlstring nullable

Compressed frames data URL

compressed_frames_last_updated_atstring nullable

Compressed frames last update timestamp

compressed_frames_schema_versionstring nullable

Schema version for compressed frames

created_atstring nullable

Creation timestamp

csv_analysis_urlstring nullable

CSV analysis file URL

csv_statusstring nullable

CSV generation status

descriptionstring nullable

Video description

dropbox_urlstring nullable

Dropbox URL if applicable

durationnumber nullable

Video duration in seconds

emotions_liststring[] nullable

List of emotion labels

end_millisnumber nullable

End time in milliseconds

face_deletion_statusstring nullable

Face deletion status

face_duplicate_countinteger nullable

Count of duplicate faces detected

face_emotionsobject nullable

Face emotions per face ID

facesobject[] nullable

Detected faces with emotions

fpsnumber nullable

Frames per second

frame_upload_progressinteger nullable

Frame upload progress percentage

frame_upload_statusstring nullable

Frame upload status

frames_with_faces_countinteger nullable

Frames with detected faces

heightnumber nullable

Video height in pixels

highlight_segmentsobject[] nullable

Highlight video segments

highlight_statusstring nullable

Highlight video status

highlight_urlstring nullable

Highlight video URL

idstring nullable

Unique video identifier

is_userboolean nullable

Whether uploaded by user

media_sourcestring nullable

Source type: youtube, dropbox, public_url, file_upload

media_source_urlstring nullable

Original URL as provided

messagestring nullable

Status message

model_idstring nullable

Model used for processing

orientationstring nullable

Video orientation (PORTRAIT/LANDSCAPE)

overall_emotionsobject nullable

Overall emotion scores for video

pdf_generation_timestampstring nullable

PDF generation timestamp

pdf_statusstring nullable

PDF report status

pdf_urlstring nullable

PDF report URL

predefined_qaobject[] nullable

Predefined Q&A data

personality_dataobject[] nullable

Personality analysis data

personality_processingstring nullable

Personality processing progress

personality_statusstring nullable

Personality analysis status

processed_secondsnumber nullable

Processing time in seconds

processing_fpsinteger nullable

Reduced processing frame-rate tier (15/5/1), or null for full/native fps

project_idstring nullable

Associated project ID

psychologist_reviewstring nullable

Psychologist review content

psychologist_review_statusstring nullable

Psychologist review status

share_statusboolean nullable

Whether video is shared

start_millisnumber nullable

Start time in milliseconds

statusstring nullable

Processing status

tags_mapobject nullable

Legacy tags_map (sample flag only). No new keys here — use the tags field instead.

text_idstring nullable

Associated text analysis ID

thumbnailstring nullable

Thumbnail image URL

titlestring nullable

Video title

total_frames_countinteger nullable

Total frames count

ui_requestboolean nullable

Whether request came from UI

urlstring nullable

Original video URL

user_idstring nullable

Owner user ID

video_csv_urlstring nullable

Video-specific CSV analysis URL

widthnumber nullable

Video width in pixels

youtube_urlstring nullable

YouTube URL if applicable