---
title: "Get Kol Videos"
method: GET
path: "/api/kols/{username}/videos"
tags: ["KOL Database"]
---

# Get Kol Videos

`GET /api/kols/{username}/videos`

## Request

- Base URL: `https://api.kolens.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.kolens.ai/api/kols/{username}/videos`
- Auth: HTTP bearer

Return top videos for a KOL the caller has discovered (personally
or via their workspace), sorted by view count descending. Returns
an empty list when neither the caller nor their workspace has seen
the video — matches the 404-style isolation on the profile endpoint
without leaking the existence of someone else's KOL via partial data.

## Path parameters

- `username` string, required

## Query parameters

- `limit` integer

## Headers

- `x-kolens-user-id` string, nullable
- `x-kolens-workspace-id` string, nullable

## Response `200`

Successful Response

- VideoOut[]
  - `video_id` string, required
  - `url` string, nullable, required
  - `thumbnail_url` string, nullable, required
  - `caption` string, nullable, required
  - `hashtags` string[], required
  - `views` integer, nullable, required
  - `likes` integer, nullable, required
  - `comments` integer, nullable, required
  - `shares` integer, nullable, required
  - `duration_seconds` integer, nullable, required
  - `music_title` string, nullable, required
  - `is_ad` boolean, required
  - `user_role` string, nullable, required
  - `search_query` string, nullable, required
  - `created_at` string, nullable, required
  - `language` string, nullable
  - `is_sponsored` boolean
  - `is_slideshow` boolean
  - `is_pinned` boolean
  - `reposts` integer, nullable
  - `location_created` string, nullable
  - `music_id` string, nullable
  - `music_author` string, nullable
  - `music_original` boolean, nullable
  - `mentions` string[]

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kolens/apis/kolens-api.md) · [All operations](https://skmtc.dev/kolens/apis/kolens-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kolens/apis/kolens-api/revisions/5d6865ab0a24?raw)