KOL Database

Create Kol Audience

Run a fresh audience sample. Pre-charges credits via the same pattern as /api/kols/profile-scrape and refunds on hard failure.

post/api/kols/{username}/audience

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

Path parameters

usernamestring required

Headers

x-kolens-user-idstring nullable

Request body

sample_sizeinteger

200 | 500 | 2000

Response

Successful Response

idstring required
usernamestring required
sampled_atstring required
sample_sizeinteger required
platformstring
sample_methodstring
countriesobject
languagesobject
follower_tier_distobject
top_hashtagsobject[]
active_pctnumber nullable
raw_count_activeinteger nullable
raw_count_totalinteger nullable
confidence_pctnumber nullable
error_margin_pctnumber nullable
charged_creditsinteger nullable

Changes

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