v1
latestOpenAPI 3.1.02026-08-04118425322.0 KBsearch-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