---
title: "Get creators similar to a given creator within an agent (BETA)"
method: GET
path: "/v1/agents/{id}/creators/{creator_id}/similar"
tags: ["Content Research Agents"]
---

# Get creators similar to a given creator within an agent (BETA)

`GET /v1/agents/{id}/creators/{creator_id}/similar`

## Request

- Base URL: `https://api.virlo.ai`
- URL: `https://api.virlo.ai/v1/agents/{id}/creators/{creator_id}/similar`
- Auth: HTTP bearer

**BETA** — directional signal, methodology may evolve. Similarity is co-occurrence based: other creators in the agent’s corpus ranked by shared hashtags and shared sounds with the target creator (no embeddings / follow-graph in v1). Free — reads on already-paid-for data.

## Path parameters

- `id` string, required
- `creator_id` string, required

## Query parameters

- `limit` number

## Response `200`

Similar creators

- AgentSimilarCreatorsResponseDto
  - `data` CometSimilarCreatorItemDto[], required
    - `author_id` string, required
    - `username` string, required
    - `avatar_url` string, nullable
    - `url` string, nullable
    - `verified` boolean, required
    - `followers` number, nullable
    - `shared_hashtag_count` number, required: Distinct hashtags shared with the target creator within the niche
    - `shared_sound_count` number, required: Distinct sounds shared with the target creator within the niche
    - `similarity_score` number, required: shared_hashtag_count + 2×shared_sound_count

## Other responses

- `401`: Missing or invalid API key (`missing_api_key` / `invalid_api_key`)
- `404`: Agent not found
- `429`: Rate limit exceeded (`rate_limit_exceeded`); see the Retry-After header

---

[API](https://skmtc.dev/virlo/apis/virlo-public-api.md) · [All operations](https://skmtc.dev/virlo/apis/virlo-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/virlo/apis/virlo-public-api/revisions/3b69c6145087?raw)