---
title: "Fetch detailed KOL profile information with recent videos by KOL IDs"
method: POST
path: "/api/v1/kols/details-n-videos"
tags: ["KOL"]
---

# Fetch detailed KOL profile information with recent videos by KOL IDs

`POST /api/v1/kols/details-n-videos`

## Request

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

Accepts a list of KOL IDs and returns the full profile data for each KOL 
along with their most recent N videos from the influencer_videos table.
Thumbnails that don't contain 'supabase.co' are replaced with a default image.

## Request body

- object
  - `kol_ids` string[], required: List of KOL IDs to fetch profile data for.
  - `max_videos` integer: Maximum number of recent videos to fetch per KOL (default 10)

## Response `200`

Successfully fetched KOL details with recent videos.

- object
  - `success` boolean
  - `kols` KolWithVideos[]
    - `kol_id` string
    - `name` string
    - `avatar` string
    - `followers` number
    - `country` string
    - `channel` string
    - `email` string
    - `language` string
    - `is_official` boolean
    - `biography` string
    - `profile_url` string
    - `median_views` number
    - `average_views` number
    - `total_views` number
    - `total_likes` number
    - `total_comments` number
    - `total_shares` number
    - `average_likes` number
    - `average_comments` number
    - `average_engagement` number
    - `average_shares` number
    - `median_engagement` number
    - `median_likes` number
    - `median_comments` number
    - `median_shares` number
    - `recent_videos` VideoData[]
      - `id` string: Unique video identifier
      - `kol_id` string: KOL identifier
      - `video_id` string: Platform-specific video ID
      - `title` string, nullable: Video title
      - `cover` string, nullable: Video thumbnail URL
      - `duration` number, nullable: Video duration in seconds
      - `play_count` number, nullable: Number of video plays
      - `digg_count` number, nullable: Number of likes/digs
      - `comment_count` number, nullable: Number of comments
      - `share_count` number, nullable: Number of shares
      - `create_time` number, nullable: Video creation timestamp (Unix timestamp)
      - `channel` string: Social media platform/channel
      - `generated_description` string, nullable: AI-generated content description in format: "subject_analysis|<=>|scene_analysis"
      - `created_at` string, date-time: Record creation timestamp
      - `updated_at` string, date-time: Record last update timestamp
  - `matched_count` integer
  - `time_elapsed` number
  - `performance` object
    - `kol_lookup_ms` number: Time spent looking up KOLs by ID
    - `kol_processing_ms` number: Time spent processing KOL data
    - `video_fetch_ms` number: Time spent fetching videos
    - `kol_ids_processed` integer: Number of unique KOL IDs processed
    - `kols_found` integer: Number of KOLs found after deduplication

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