---
title: "Collect KOC details for given KOLs via thumbnails and captions analysis"
method: POST
path: "/api/v1/collect-koc-details"
tags: ["KOL"]
---

# Collect KOC details for given KOLs via thumbnails and captions analysis

`POST /api/v1/collect-koc-details`

## Request

- Base URL: `https://api.kolect.com`
- URL: `https://api.kolect.com/api/v1/collect-koc-details`
- Auth: HTTP bearer

For each KOL, fetch recent videos from database, re-fetch fresh thumbnails via TikTok RapidAPI,
and analyze thumbnails and captions using OpenAI to infer KOC details.

## Request body

- object
  - `kol_ids` string[], required
  - `max_videos` integer

## Response `200`

Success

- object
  - `success` boolean
  - `data` object[]
    - `kol_id` string
    - `koc_details` object
      - `thumbnails` object
        - `often_do_voiceover` boolean
        - `shows_face` boolean
        - `appearance_score` number
        - `ethnicity` string
        - `visual_age` number
        - `gender` string
      - `captions` object
        - `ads_ratio_recent` number
        - `category_niche` string
    - `new_thumbnails` object[]
      - `video_id` string
      - `cover` string, nullable
      - `origin_cover` string, nullable
  - `processing_time_ms` number

## Other responses

- `400`: Bad request
- `500`: Internal 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)