v1

latestOpenAPI 3.1.02026-08-04118425322.0 KB
search-video > searchVideo

Get Detailed Video Search By Id

Retrieves composite slices (shots, scenes, etc.) within a specific video ranked by their similarity to a text query. Given a video_id and text_query, this endpoint performs a drill-down search to find moments within that video. The text query is encoded using the dataset's configured shot-level encoder (e.g., Perception Encoder or other vision-language embedding models), then searched against shot embeddings for that specific video. Returns a ranked list of composite slices ordered by similarity score, including timestamps (start_time_ms, end_time_ms), frame numbers, and representative keyframes.

get/api/v1/search/video

Query parameters

dataset_idstring required

Dataset identifier

text_querystring required

Text query for search

video_idstring required

Video identifier

composite_typestring

Type of composite

limitinteger

Maximum number of slices to return

Headers

Authorizationstring required

Bearer authentication

Response

Successful Response

dataset_idstring uuid required
text_querystring required
video_idstring required
composite_typestring required
source_pathstring required