---
title: "Advanced search for videos with subject and scene analysis"
method: POST
path: "/api/search-video-similarity"
tags: ["Search"]
---

# Advanced search for videos with subject and scene analysis

`POST /api/search-video-similarity`

## Request

- Base URL: `https://api.kolect.com`
- URL: `https://api.kolect.com/api/search-video-similarity`
- Auth: HTTP bearer

Search for videos using separate subject and scene embeddings with inclusion/exclusion criteria

## Request body

- object
  - `subjectInclusionQuery` string: Query for subject content to include
  - `subjectExclusionQuery` string: Query for subject content to exclude
  - `sceneInclusionQuery` string: Query for scene content to include (optional)
  - `sceneExclusionQuery` string: Query for scene content to exclude
  - `subjectSimilarityThreshold` number: Minimum similarity threshold for subject analysis (0-1)
  - `sceneSimilarityThreshold` number: Minimum similarity threshold for scene analysis (0-1)
  - `subjectExclusionStrength` number: Strength of subject exclusion (0-1)
  - `sceneExclusionStrength` number: Strength of scene exclusion (0-1)
  - `topK` number: Maximum number of results
  - `subjectWeight` number: Weight for subject similarity (0-1, must sum with sceneWeight to 1.0)
  - `sceneWeight` number: Weight for scene similarity (0-1, must sum with subjectWeight to 1.0)
  - `channel` 'tiktok' | 'instagram' | 'youtube': Platform channel filter
  - `embedding_type` string

## Response `200`

Successfully found matching videos

## Other responses

- `400`: Invalid parameters
- `500`: Server error

---

[API](https://skmtc.dev/kolect/apis/kolect-api.md) · [All operations](https://skmtc.dev/kolect/apis/kolect-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kolect/apis/kolect-api/revisions/fe54528e8f54?raw)