---
title: "Compare two influencers based on their video embeddings"
method: POST
path: "/api/influencer/video/compare-sum"
tags: ["Influencers"]
---

# Compare two influencers based on their video embeddings

`POST /api/influencer/video/compare-sum`

## Request

- Base URL: `https://api.kolect.com`
- URL: `https://api.kolect.com/api/influencer/video/compare-sum`
- Auth: HTTP bearer

Retrieves video embeddings for two influencers, calculates individual similarities, and returns an aggregated similarity score. If influencers have no videos, will try to fetch videos first.

## Request body

- object
  - `influencer1Id` string, required: ID of the first influencer
  - `influencer2Id` string, required: ID of the second influencer to compare with
  - `limit` integer: Maximum number of videos to use from each influencer
  - `cutoff` integer: Only use the top N most similar video pairs for the final similarity score
  - `force_recalculate` boolean: Force recalculation of embeddings even if cached

## Response `200`

Similarity comparison results

- object
  - `overall_similarity_score` number
  - `video_similarities` object[]
    - `source_video_id` string
    - `target_video_id` string
    - `similarity` number
  - `source_influencer` object
  - `target_influencer` object
  - `execution_time_ms` number
  - `time_breakdown` object
  - `videos_fetched` boolean: Whether videos were fetched as part of this request

## Other responses

- `400`: Bad request - Missing or invalid input
- `404`: One or both influencers not found
- `500`: Server error during processing

---

[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)