KOL Database

Get Kol Overview

Holistic creator overview — the partnership manager's first read.

Cache-first (30-day TTL); refresh=true forces a fresh LLM call and charges 1 credit. Authors with zero scraped videos return a "not enough data" overview without burning a credit.

get/api/kols/{username}/overview

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}/overview
  • Auth: HTTP bearer

Path parameters

usernamestring required

Query parameters

localestring

Output locale — en / zh-CN / ja

refreshboolean

Force fresh LLM call + cache replace

Headers

x-kolens-user-idstring nullable
x-kolens-workspace-idstring nullable

Response

Successful Response

overall_summarystring required
content_themesstring[] required
audience_signalstring required
partnership_signalsstring[] required
red_flagsstring[] required
fit_forstring[] required
recommendation_scoreinteger nullable
content_fit_scoreinteger nullable
audience_fit_scoreinteger nullable
risk_scoreinteger nullable
score_rationalestring nullable
brand_profile_statusstring
workspace_slugstring nullable
generated_atstring required
videos_analyzedinteger required
cost_creditsinteger required
model_usedstring nullable
cachedboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.