# solari insight instagram ranking creators

> Rank Instagram creators within a category.

- **CLI**: `solari insight instagram ranking creators`
- **MCP 도구**: `solari_insight_instagram_ranking_creators`
- **권한**: `solari:read` — 체험을 포함해 모든 SOLARI 플랜에서 쓸 수 있어요. 성공한 호출 1번에 1 크레딧이에요.
- **이용 가능 플랜**: Any paid plan or trial
- **크레딧**: 1

Creator leaderboard for one market: creators who make brand-tagged content, ranked within a category so a specialist isn't beaten by a big account with one post in it. Brand, agency, and shop accounts are left out.

**언제 쓰나** — When you want the top creators for a category, by reach, efficiency, or growth. For brands, use ranking brands.

**무엇이 나오나** — One page of ranked creators, plus any creator you asked to find (lookup).

## 파라미터

- `region` (enum, 선택, 기본값 "KR") — KR or JP — the creator's own market. 값: `KR`, `JP`.
- `days` (integer, 선택, 기본값 30) — 30 or 90.
- `sort` (enum, 선택, 기본값 "plays") — What to rank by: total views, views per post, likes, brands worked with, sponsored views, reach, lift, or growth. 값: `plays`, `median_plays`, `likes`, `brands`, `sponsored_plays`, `reach`, `lift`, `growth`.
- `kind` (enum, 선택, 기본값 "creator") — creator for individuals, magazine for magazine and media accounts. 값: `creator`, `magazine`.
- `scope` (string, 선택, ≤ 120 chars) — Category: all, d1:<group>, or d2:<group>/<category>. Valid values come back in categories and category_groups.
- `brand_account_id` (string, 선택, 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)$) — A brand's account_id. Opens the board in that brand's top category.
- `brand_username` (string, 선택, ≤ 64 chars) — A brand's username. Ignored when brand_account_id is set.
- `find_username` (string, 선택, ≤ 64 chars) — Any creator username to locate on this board.
- `min_posts` (integer, 선택, 기본값 3) — Only creators with at least this many posts in the category: 3, 10, or 30.
- `min_followers` (integer, 선택, 기본값 10000) — Follower floor: 1000, 10000, or 100000.
- `limit` (integer, 선택, ≥ 1) — How many rows per page.
- `offset` (integer, 선택, 기본값 0, ≥ 0) — How many rows to skip.

## 응답

### `Response`

- `region / days / sort / list_kind` (string · integer) — Settings applied.
- `scope / scope_source` (string) — Category ranked in, and where it came from.
- `min_posts / min_followers / min_reels` (integer) — Filters applied. min_reels applies to the sorts that need reels.
- `total` (integer) — Creators in this category.
- `max_rank` (integer) — The deepest rank you can page to.
- `snapshot_ready` (boolean) — false while the first board is still being built.
- `median_metric / sponsored_share_median` (number | null) — Category medians. First page only.
- `snapshot_at` (timestamp | null) — When the board was built.
- `items` (object[]) — Ranked creators.
- `lookup / lookup_reason / lookup_scopes` (object | string | string[]) — Same as ranking brands, for find_username.
- `categories / category_groups` (object[]) — Valid scopes with their creator counts.

### `items[] · lookup.row`

- `rank` (integer) — Position on the board.
- `account_id` (uuid) — account_id for the other tools.
- `username / full_name` (string) — Handle and display name.
- `follower_count` (integer | null) — Followers.
- `post_count / reel_count` (integer) — Brand-tagged posts and reels in the category.
- `brand_count` (integer) — Brands tagged in those posts.
- `total_plays / median_plays` (integer) — Total views and views per post.
- `total_likes / total_comments` (integer) — Engagement.
- `sponsored_post_count / sponsored_total_plays / sponsored_median_plays` (integer) — The same numbers for sponsored posts only.
- `organic_median_plays` (integer | null) — Views per post for non-sponsored posts.
- `organic_post_count / organic_total_plays` (integer | null) — Posts and total views without the sponsored ones. Null when the counts don't add up.
- `sponsored_share` (number | null) — Sponsored posts over all posts, 0–1. Null when there are no posts.
- `baseline_median_views` (integer | null) — The creator's usual views per post across everything they post.
- `ad_partner_count` (integer | null) — Brands they've run ads for.
- `reach_rate` (number | null) — Views per follower. Null when the baseline is too small.
- `lift` (number | null) — Views per post against their own usual median. 1.5 means 50% above usual.
- `growth_m1` (number | null) — One-month view growth. 0.27 means +27%.

## 예시

```console
$ solari insight instagram ranking creators region=KR days=30 scope=d2:BEAUTY/MAKEUP limit=1
```

_읽기 편하도록 긴 문자열과 반복되는 배열 항목을 줄였어요._

```json
{
  "region": "KR",
  "days": 30,
  "sort": "plays",
  "max_rank": 1000,
  "list_kind": "creator",
  "scope": "d2:BEAUTY/MAKEUP",
  "scope_source": "explicit",
  "min_posts": 3,
  "min_followers": 10000,
  "min_reels": 0,
  "offset": 0,
  "limit": 1,
  "snapshot_ready": true,
  "total": 2841,
  "median_metric": 61200,
  "sponsored_share_median": 0.4,
  "snapshot_at": "2026-09-22T19:04:11.482913+00:00",
  "lookup_username": null,
  "lookup_reason": null,
  "lookup_scopes": [],
  "categories": [
    {
      "depth_1": "BEAUTY",
      "creators": 2841,
      "depth_2": "MAKEUP"
    },
    {
      "depth_1": "BEAUTY",
      "creators": 2310,
      "depth_2": "SKINCARE"
    },
    "… 38 more"
  ],
  "category_groups": [
    {
      "depth_1": "BEAUTY",
      "creators": 5120
    },
    "… 11 more"
  ],
  "items": [
    {
      "account_id": "018ecc75-55d8-70a7-a348-d370aa504ed9",
      "rank": 1,
      "user_id": "018ecc75-55d8-70a7-a348-d370aa504ed9",
      "username": "beinny_motd",
      "full_name": "베이니 BEINNY",
      "follower_count": 205754,
      "post_count": 22,
      "brand_count": 14,
      "reel_count": 19,
      "total_plays": 3120400,
      "median_plays": 98200,
      "total_likes": 84210,
      "total_comments": 3120,
      "sponsored_post_count": 15,
      "sponsored_total_plays": 2010300,
      "sponsored_median_plays": 91200,
      "organic_median_plays": 112000,
      "baseline_median_views": 64000,
      "ad_partner_count": 14,
      "reach_rate": 0.48,
      "lift": 1.53,
      "growth_m1": 0.27,
      "organic_post_count": 7,
      "organic_total_plays": 1110100,
      "sponsored_share": 0.6818
    }
  ],
  "lookup": null
}
```

## MCP 호출로 쓰면

```json
{
  "name": "solari_insight_instagram_ranking_creators",
  "arguments": {
    "region": "KR",
    "days": 30,
    "scope": "d2:BEAUTY/MAKEUP",
    "limit": 1
  }
}
```

## 주의사항

- The board is rebuilt daily. snapshot_at tells you when.
- reach, lift, and growth are null for creators whose baseline is too small.
- Creators only count in categories that make up a real share of their posts.

## 관련 도구

- [`solari_insight_instagram_ranking_posts`](https://pub.brandazine.ai/docs/tools/insight-instagram-ranking-posts.md?lang=ko)
- [`solari_insight_instagram_ranking_find`](https://pub.brandazine.ai/docs/tools/insight-instagram-ranking-find.md?lang=ko)
- [`solari_insight_instagram_account_discover`](https://pub.brandazine.ai/docs/tools/insight-instagram-account-discover.md?lang=ko)