---
title: "Get Public Kol Dossier"
method: GET
path: "/api/public/kols/{username}"
tags: ["public"]
---

# Get Public Kol Dossier

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

## 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/public/kols/{username}`
- Auth: none declared

Public KOL dossier — no auth required.

Returns 404 when:
  - the creator doesn't exist in our database, OR
  - the creator's follower count is at or below
    ``PUBLIC_FOLLOWER_THRESHOLD`` (100k by default).

Both cases share the same 404 response so we never leak "this
creator exists but isn't public yet" via response shape.

## Path parameters

- `username` string, required

## Query parameters

- `platform` string

## Response `200`

Successful Response

- PublicDossierOut: Pydantic mirror of ``kol_public_page.PublicDossier``. Keeping these two definitions in lock-step is the privacy contract — any field that appears here MUST also appear in the dataclass.
  - `username` string, required
  - `platform` string, required
  - `display_name` string, nullable
  - `avatar_url` string, nullable
  - `bio` string, nullable
  - `profile_url` string, nullable
  - `follower_count` integer, required
  - `posts_count` integer, nullable
  - `total_hearts` integer, nullable
  - `verified` boolean
  - `role` string, required
  - `audience` PublicAudienceOut, required
    - `top_countries` object[]
    - `language` string, nullable
  - `account_created_at` string, nullable
  - `first_seen_at` string, nullable
  - `last_video_at` string, nullable
  - `avg_views` number, nullable
  - `avg_engagement_rate` number, nullable
  - `recent_videos` PublicVideoOut[]
    - `video_id` string, required
    - `url` string, nullable
    - `thumbnail_url` string, nullable
    - `caption` string, nullable
    - `view_count` integer, nullable
    - `like_count` integer, nullable
    - `comment_count` integer, nullable
    - `posted_at` string, nullable
  - `authenticity` PublicAuthenticityOut
    - `score` integer, required
    - `confidence` string, required
    - `tier_label` string, required
  - `computed_at` string, required
  - `public_threshold` integer

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