---
title: "Fetch detailed KOL profile information (batched)"
method: POST
path: "/api/v1/kols/details"
tags: ["KOL"]
---

# Fetch detailed KOL profile information (batched)

`POST /api/v1/kols/details`

## Request

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

Accepts a list of KOL IDs and (optionally) a mapping of video IDs belonging to each KOL.
Returns the full profile data for each requested KOL and, when `videos_by_kol` is supplied, an array of matched video titles is embedded inside each KOL object.

## Request body

- object
  - `kol_ids` string[], required: List of KOL IDs that need to be fetched. If omitted, keys of `videos_by_kol` will be used.
  - `videos_by_kol` object: Optional mapping **kol_id → array of video_id**. When provided, the service will fetch titles for these videos and attach them to the corresponding KOL in the response.

## Response `200`

Successfully fetched KOL details.

- object
  - `success` boolean
  - `kols` KolDetail[]
    - `kol_id` string
    - `name` string
    - `avatar` string
    - `followers` number
    - `country` string
    - `channel` string
    - `email` string
    - `language` string
    - `is_official` boolean
    - `biography` string
    - `metadata` object
    - `profile_url` string
    - `median_views` number
    - `average_views` number
    - `campaign_id` string
    - `matched_video_titles` MatchedVideoTitle[]
      - `video_id` string
      - `title` string
  - `matched_count` integer
  - `time_elapsed` number
  - `performance` object
    - `batches_processed` integer
    - `kol_rpc_ms` number

## Other responses

- `400`: Invalid request payload.
- `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)