KOL Database

Get Kol Activity Summary

EPIC #208 Phase 1 — what's this KOL up to lately.

Cache-first (24h TTL); refresh=true forces a fresh LLM call and charges 1 credit. Authors with no recent videos return a "no data" response without burning a credit (so a later video import immediately benefits).

get/api/kols/{username}/activity-summary

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

Path parameters

usernamestring required

Query parameters

periodstring
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

summarystring required
highlightsstring[] required
talking_pointsstring[] required
competitor_mentionsstring[] required
periodstring required
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.