KOL Database

Post Kol Audience Insights

AI interpretation of the audience snapshot — cache-first.

Same caching story as /kols/{u}/outreach: pre-2026-05-18 this ran the LLM on every "Interpret" click. Now cached per (workspace, username, locale) and gated on a SHA-256 of the snapshot payload so a re-sampled audience invalidates the cached interpretation.

post/api/kols/{username}/audience/insights

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}/audience/insights
  • 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

Request body

snapshotobject required

Response

Successful Response

summarystring required
content_anglesstring[] required
outreach_anglestring nullable
caveatsstring nullable
generated_atstring required
model_usedstring nullable
cachedboolean required

Changes

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