---
title: "Public Kols Aggregated Directory"
method: GET
path: "/api/public/kols/directory/aggregated"
tags: ["public"]
---

# Public Kols Aggregated Directory

`GET /api/public/kols/directory/aggregated`

## 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/aggregated`
- Auth: none declared

Deduped, multi-platform creator directory: ONE entry per person
(grouped by shared handle across TikTok / Instagram / X / Douyin), each
carrying its platform list + summed reach. This is what lets a list show
a single unified creator instead of duplicate per-platform cards.

## Query parameters

- `limit` integer
- `offset` integer
- `category` string, nullable
- `min_followers` integer

## Response `200`

Successful Response

- AggregatedDirectoryResponse
  - `entries` AggregatedCreatorOut[], required
    - `handle` string, required
    - `primary_platform` string, required
    - `display_name` string, nullable
    - `avatar_url` string, nullable
    - `total_reach` integer, required
    - `platform_count` integer, required
    - `platforms` PlatformPresenceOut[], required
      - `platform` string, required
      - `username` string, required
      - `follower_count` integer, nullable
      - `avg_views` number, nullable
      - `avg_engagement_rate` number, nullable
      - `profile_url` string, nullable
      - `avatar_url` string, nullable
      - `display_name` string, nullable
      - `is_verified` boolean
      - `category` string, nullable
    - `confidence` string, required
    - `category` string, nullable
    - `summary` string
  - `count` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kolens/apis/kolens-api.md) · [All operations](https://skmtc.dev/kolens/apis/kolens-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kolens/apis/kolens-api/revisions/5d6865ab0a24?raw)