public

Public Kols Directory

Rich creator cards for the public directory (#648). Same eligibility + follower-desc ordering as the sitemap endpoint, but returns reach/quality signals (followers, engagement, avg views, category, country, verified) so the frontend can render proper KOL cards instead of just a handle. NEVER includes contact/email — reuses the canonical public projection (featured_collections.project_author).

category (optional) keeps the niche landing pages on-topic: pass the niche's keywords and only creators in that topic come back, instead of the global follower leaders.

get/api/public/kols/directory

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/directory
  • Auth: none declared

Query parameters

platformstring nullable
limitinteger
offsetinteger
categorystring nullable

Comma-separated topic keywords; restricts to creators whose inferred category or bio matches any keyword (niche pages).

Response

Successful Response

totalinteger required
truncatedboolean required

Changes

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