Face Match

Find matching face in video

Search for a source face in a target video using facial recognition

post/face-match

Request

target_video_urlstring required

URL of the target video to search in

max_facesinteger

Maximum number of faces to return

face_detection_idstring uuid

Optional: Use previously analyzed face detections in video

frame_extraction_idstring uuid

Optional: Use previously extracted frames

Face match job created successfully

face_match_idstring uuid required

Unique identifier for the face match job

face_detection_idstring uuid

ID of the face detection analysis used

frame_extraction_idstring uuid

ID of the frame extraction used

file_idstring uuid

ID of the target file

status'pending' | 'processing' | 'completed' | 'failed' required

Status of the face match job

created_atnumber required

Unix timestamp in milliseconds when the job was created