# solari instagram account similar

> Find Instagram accounts whose relationship graph overlaps a given handle.

- **CLI**: `solari instagram account similar`
- **MCP tool**: `solari_instagram_account_similar`
- **Access**: `solari:read` — Works with any signed-in SOLARI account.

Finds Instagram accounts similar to the given username based on relationship-graph overlap. Takes an Instagram handle (no @), not a UUID. Works with any signed-in SOLARI account.

**When to use it** — "Who else is like this creator?" — graph adjacency, not collaboration history.

**What comes back** — The seed account, the similar accounts, and diagnostics describing the traversal.

## Parameters

- `username` (string, required) — Instagram handle to find similar accounts for, without the leading @.
- `limit` (integer, optional, ≥ 1) — Number of similar accounts to return, default 50. Values above 100 are clamped to 100.

## Response

### `Response`

- `user_id` (uuid) — Seed account id.
- `user` (object) — Seed account profile summary.
- `params` (object) — Traversal parameters actually applied (k, hops, max_rank_to_use).
- `results` (object[]) — Similar accounts, score descending.
- `diagnostics` (object) — Neighbours used, algorithm, and build time — useful when a result looks off.

### `results[]`

- `user_id` (uuid) — account_id of the similar account.
- `username` (string) — Handle.
- `full_name / bio` (string) — Display name and bio text.
- `score` (number) — Graph-overlap score. Comparable only within this response.
- `follower_count` (integer) — Follower count.
- `region` (string) — Region code.
- `has_collaborated` (boolean) — Whether this account has an ad collaboration with the seed.
- `last_collaboration_date` (date | null) — Most recent collaboration date.
- `recent_media` (object[]) — Recent post previews.

## Example

```console
$ solari instagram account similar username=oliveyoung_official limit=8
```

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

```json
{
  "user_id": "018cab6d-1648-7071-9734-c47a2be2fd19",
  "user": {
    "user_id": "018cab6d-1648-7071-9734-c47a2be2fd19",
    "username": "oliveyoung_official",
    "full_name": "올리브영 OLIVE YOUNG",
    "profile_pic_url": "https://dcr.bzine.co/instagram/users/oliveyoung_official/profile-picture",
    "follower_count": 1199628,
    "region": "KR",
    "is_verified": null
  },
  "params": {
    "k": 8,
    "hops": 3,
    "max_rank_to_use": 25
  },
  "results": [
    {
      "user_id": "018cabd4-926b-7a58-b0cb-11dfc7c37006",
      "username": "gs25_official",
      "score": 0.1515,
      "profile_pic_url": "https://dcr.bzine.co/instagram/users/gs25_official/profile-picture",
      "follower_count": 1017802,
      "median_views": null,
      "full_name": "대한민국 대표 편의점 GS25",
      "bio": "더 재미있게 더 실속있게\n오늘 가장 최신의 트렌드를 만나는\n#25매거진 #재미있는GS25 #라이프스타일플랫폼",
      "region": "KR",
      "has_collaborated": false,
      "last_collaboration_date": null,
      "recent_media": [
        {
          "post_id": "01a062a3-a504-7fe5-b53f-7cd291ffceff",
          "media_type": "image",
          "source_url": "https://bzine.co/cdn-cgi/image/fit=scale-down,width=480/https://smr-images.bzine.co/users/018cabd4-926b-7a58-b0cb-11dfc7c37006/posts/01a062a3-a504-7fe5-b53f-7cd291ffceff/medias/01a062a3-a7f8-702c-994f-bd426afe5d74.jpg",
          "thumbnail_url": "https://bzine.co/cdn-cgi/image/fit=scale-down,width=480/https://smr-images.bzine.co/users/018cabd4-926b-7a58-b0cb-11dfc7c37006/posts/01a062a3-a504-7fe5-b53f-7cd291ffceff/medias/01a062a3-a7f8-702c-994f-bd426afe5d74.jpg",
          "slug": "Dcx-Nrij7IV",
          "media_url": "https://bzine.co/cdn-cgi/image/fit=scale-down,width=480/https://smr-images.bzine.co/users/018cabd4-926b-7a58-b0cb-11dfc7c37006/posts/01a062a3-a504-7fe5-b53f-7cd291ffceff/medias/01a062a3-a7f8-702c-994f-bd426afe5d74.jpg",
          "play_count": null,
          "posted_at": "2026-09-02T10:00:09+00:00"
        },
        "… 3 more"
      ],
      "collaborated_with": []
    },
    "… 7 more"
  ],
  "diagnostics": {
    "neighbors_used": 4930,
    "unique_terms": 25,
    "build_ms": 7664,
    "algorithm": "distance_weighted_jaccard",
    "max_rank_used": 25,
    "target_related_count": 25
  }
}
```

## As an MCP call

```json
{
  "name": "solari_instagram_account_similar",
  "arguments": {
    "username": "oliveyoung_official",
    "limit": 8
  }
}
```

## Notes

- Takes a handle only — an account_id UUID is not accepted here.
- For similarity by brand collaboration instead of graph overlap, use brand top collaborators.

## Related tools

- [`solari_instagram_account_search`](https://solari.sh/docs/tools/instagram-account-search.md)
- [`solari_instagram_brand_top_collaborators`](https://solari.sh/docs/tools/instagram-brand-top-collaborators.md)
