# solari instagram brand top collaborators

> Creators ranked by how often they have run ads for a brand.

- **CLI**: `solari instagram brand top collaborators`
- **MCP tool**: `solari_instagram_brand_top_collaborators`
- **Access**: `solari:read` — Works with any signed-in SOLARI account.

Ranked list of creators who authored resolved ad posts targeting the brand, ordered by collaboration count. Identify the brand by account_id (SOLARI account UUID from solari_instagram_account_search) or by username (Instagram handle); an unknown reference returns a not-found error. Retrospective collaboration history, not a forward-looking fit score. Works with any signed-in SOLARI account.

**When to use it** — "Who does this brand work with?" Retrospective history, not a forward-looking fit score.

**What comes back** — Creators ordered by collaboration count.

## Parameters

- `account_id` (string, optional, uuid, pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$) — Brand account_id (SOLARI account UUID) from solari_instagram_account_search. Provide this or username.
- `username` (string, optional, ≤ 64 chars) — Brand Instagram handle, with or without a leading @. Ignored when account_id is set.
- `promotion` (enum, optional, default "all") — Ad-post promotion filter: all rows, promotion=true rows, or promotion=false rows. Values: `all`, `true_only`, `false_only`.
- `limit` (integer, optional, ≥ 1) — Maximum creators returned, default 20. Values above 1000 are clamped to 1000.
- `offset` (integer, optional, default 0, ≥ 0) — Pagination offset, default 0.

## Response

### `Response`

- `brand_id` (uuid) — The resolved brand account_id.
- `promotion_filter` (string) — The promotion filter applied.
- `items` (object[]) — Creators, collaboration count descending.
- `total_count` (integer) — Creators matching the filter.

### `items[]`

- `creator_id` (uuid) — Creator account_id — the value the other tools accept.
- `username / full_name` (string) — Handle and display name.
- `profile_pic_url` (string) — Profile picture.
- `follower_count` (integer) — Follower count.
- `collaboration_count` (integer) — Collaboration posts with this brand.

## Example

```console
$ solari instagram brand top collaborators username=innisfreeofficial limit=5
```

_Long strings and repeated array entries are trimmed for readability._

```json
{
  "brand_id": "018cabce-14cc-7544-8890-7811ec33ef74",
  "promotion_filter": "all",
  "items": [
    {
      "creator_id": "0195474c-8ee3-7690-a385-71b2913e31b5",
      "username": "donge_cos",
      "full_name": "💞동이💞",
      "profile_pic_url": "https://dcr.bzine.co/instagram/users/donge_cos/profile-picture",
      "follower_count": 83354,
      "collaboration_count": 31
    },
    {
      "creator_id": "018ecc75-55d8-70a7-a348-d370aa504ed9",
      "username": "beinny_motd",
      "full_name": "베이니 BEINNY",
      "profile_pic_url": "https://dcr.bzine.co/instagram/users/beinny_motd/profile-picture",
      "follower_count": 205754,
      "collaboration_count": 29
    },
    "… 3 more"
  ],
  "total_count": 2331
}
```

## As an MCP call

```json
{
  "name": "solari_instagram_brand_top_collaborators",
  "arguments": {
    "username": "innisfreeofficial",
    "limit": 5
  }
}
```

## Notes

- limit reaches 1000. Feed the creator_ids into brand collaborator posts, 100 at a time, to hydrate their posts.
- The mirror view starting from a creator is account collabs.

## Related tools

- [`solari_instagram_brand_collaborator_posts`](https://solari.sh/docs/tools/instagram-brand-collaborator-posts.md)
- [`solari_instagram_account_collabs`](https://solari.sh/docs/tools/instagram-account-collabs.md)