---
title: "Search KOL videos by KOL ID"
method: GET
path: "/api/kol-videos"
tags: ["KOL Videos"]
---

# Search KOL videos by KOL ID

`GET /api/kol-videos`

## Request

- Base URL: `https://api.kolect.com`
- URL: `https://api.kolect.com/api/kol-videos`
- Auth: HTTP bearer

Retrieve videos for a specific KOL (Key Opinion Leader) with pagination support.
Each video includes metadata, engagement statistics, and AI-generated content analysis.

## Query parameters

- `kolId` string, required
- `page` integer
- `limit` integer

## Response `200`

Successfully retrieved videos

- object
  - `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
  - `total` integer: Total number of videos for this KOL
  - `page` integer: Current page number
  - `limit` integer: Number of videos per page
  - `hasMore` boolean: Whether there are more videos to load

## Other responses

- `400`: Bad request - missing or invalid parameters
- `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)