---
title: "Get Similar Creators"
method: GET
path: "/api/kols/{username}/similar"
tags: ["KOL Database"]
---

# Get Similar Creators

`GET /api/kols/{username}/similar`

## 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}/similar`
- Auth: HTTP bearer

Return creators similar to ``username`` — ranked by co-mention,
same-category + similar follower tier, and shared hashtags.

## Path parameters

- `username` string, required

## Query parameters

- `limit` integer

## Headers

- `x-kolens-user-id` string, nullable
- `x-kolens-workspace-id` string, nullable

## Response `200`

Successful Response

- SimilarCreatorsResponse
  - `seed` string, required
  - `candidates` SimilarCreatorOut[], required
    - `username` string, required
    - `display_name` string, nullable
    - `platform` string, nullable
    - `follower_count` integer, nullable
    - `avg_engagement_rate` number, nullable
    - `category` string, nullable
    - `country_inferred` string, nullable
    - `is_seller_like` boolean
    - `profile_url` string, nullable
    - `co_mention_count` integer
    - `same_category` boolean
    - `shared_hashtag_count` integer
    - `score` integer

## 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)