# solari insight instagram ranking brands

> Rank Instagram brands by the content around them.

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

Brand leaderboard for one market: brands ranked by how the posts that tag or mention them perform. Each row splits sponsored posts from organic ones, so you can read a brand's organic performance and how much of its reach is paid.

**언제 쓰나** — When you want who leads a category, where one brand stands, or how its organic (non-sponsored) content performs. For creators, use ranking creators.

**무엇이 나오나** — One page of ranked brands, plus your brand's position (me) and any brand you asked to find (lookup).

## 파라미터

- `region` (enum, 선택, 기본값 "KR") — KR, JP, or US. 값: `KR`, `JP`, `US`.
- `days` (integer, 선택, 기본값 30) — 30 or 90.
- `sort` (enum, 선택, 기본값 "plays") — What to rank by: total views, views per post, posts, creators, likes, sponsored views, or organic views. 값: `plays`, `median_plays`, `posts`, `creators`, `likes`, `sponsored_plays`, `organic_plays`.
- `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)$) — Your brand's account_id. Sets the default category and returns your rank as me.
- `brand_username` (string, 선택, ≤ 64 chars) — Your brand's username. Ignored when brand_account_id is set.
- `find_username` (string, 선택, ≤ 64 chars) — Any brand username to locate on this board.
- `min_posts` (integer, 선택, 기본값 1) — Only brands with at least this many posts: 1, 3, or 10.
- `limit` (integer, 선택, ≥ 1) — How many rows per page.
- `offset` (integer, 선택, 기본값 0, ≥ 0) — How many rows to skip.

## 응답

### `Response`

- `region / days / sort / min_posts` (string · integer) — Settings applied.
- `scope` (string) — Category ranked in.
- `scope_source` (string) — explicit, brand_default (your brand's top category), or default (all).
- `total` (integer) — Brands in this category.
- `median_metric` (number | null) — Median of the sort metric across the category. First page only.
- `sponsored_share_median` (number | null) — Median share of sponsored posts, 0–1. First page only.
- `snapshot_at` (timestamp | null) — When the board was built.
- `items` (object[]) — Ranked brands.
- `me` (object | null) — Your brand's rank, total, top_pct, and row.
- `me_reason` (string | null) — Why me is null: no_brand, not_in_category, below_min_posts, or no_posts.
- `lookup` (object | null) — The find_username brand's rank, total, top_pct, and row.
- `lookup_reason` (string | null) — Why lookup is null: not_in_category, below_min_posts, or no_posts.
- `lookup_scopes` (string[]) — The looked-up brand's own categories, as scopes. Retry with one of them.
- `brand_categories` (object[]) — Your brand's categories, strongest first.
- `categories / category_groups` (object[]) — Valid scopes with their brand counts.

### `items[] · me.row · 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 / creator_count` (integer) — Posts about the brand, and how many creators made them.
- `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.
- `sponsored_reel_count / organic_reel_count` (integer | null) — Reels in each subset.
- `categories` (string[]) — The brand's categories, as <group>/<category>.

## 예시

```console
$ solari insight instagram ranking brands region=KR days=30 find_username=innisfreeofficial limit=1
```

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

```json
{
  "region": "KR",
  "days": 30,
  "sort": "plays",
  "scope": "all",
  "scope_source": "default",
  "min_posts": 1,
  "offset": 0,
  "limit": 1,
  "total": 21483,
  "median_metric": 18250,
  "sponsored_share_median": 0.25,
  "snapshot_at": "2026-09-22T19:04:11.482913+00:00",
  "me_reason": "no_brand",
  "lookup_username": "innisfreeofficial",
  "lookup_reason": null,
  "lookup_scopes": [],
  "brand_categories": [],
  "categories": [
    {
      "depth_1": "BEAUTY",
      "depth_2": "MAKEUP",
      "brands": 1622
    },
    {
      "depth_1": "BEAUTY",
      "depth_2": "SKINCARE",
      "brands": 1843
    },
    "… 41 more"
  ],
  "category_groups": [
    {
      "depth_1": "BEAUTY",
      "brands": 3120
    },
    "… 11 more"
  ],
  "items": [
    {
      "account_id": "018cab6d-1648-7071-9734-c47a2be2fd19",
      "rank": 1,
      "user_id": "018cab6d-1648-7071-9734-c47a2be2fd19",
      "username": "oliveyoung_official",
      "full_name": "올리브영 OLIVE YOUNG",
      "follower_count": 1199628,
      "post_count": 18342,
      "creator_count": 6120,
      "total_plays": 412880000,
      "median_plays": 9840,
      "total_likes": 15230000,
      "total_comments": 402100,
      "sponsored_post_count": 7010,
      "sponsored_total_plays": 131200000,
      "sponsored_median_plays": 11200,
      "organic_median_plays": 9100,
      "sponsored_reel_count": 5230,
      "organic_reel_count": 8120,
      "categories": [
        "BEAUTY/SKINCARE",
        "BEAUTY/MAKEUP"
      ],
      "organic_post_count": 11332,
      "organic_total_plays": 281680000,
      "sponsored_share": 0.3822
    }
  ],
  "me": null,
  "lookup": {
    "rank": 7,
    "total": 21483,
    "top_pct": 0.1,
    "row": {
      "account_id": "018cabce-14cc-7544-8890-7811ec33ef74",
      "rank": 7,
      "user_id": "018cabce-14cc-7544-8890-7811ec33ef74",
      "username": "innisfreeofficial",
      "full_name": "INNISFREE | 이니스프리",
      "follower_count": 847619,
      "post_count": 1204,
      "creator_count": 688,
      "total_plays": 38920400,
      "median_plays": 14120,
      "total_likes": 1182300,
      "total_comments": 30440,
      "sponsored_post_count": 402,
      "sponsored_total_plays": 17610200,
      "sponsored_median_plays": 21800,
      "organic_median_plays": 11900,
      "sponsored_reel_count": 318,
      "organic_reel_count": 611,
      "categories": [
        "BEAUTY/SKINCARE"
      ],
      "organic_post_count": 802,
      "organic_total_plays": 21310200,
      "sponsored_share": 0.3339
    }
  }
}
```

## MCP 호출로 쓰면

```json
{
  "name": "solari_insight_instagram_ranking_brands",
  "arguments": {
    "region": "KR",
    "days": 30,
    "find_username": "innisfreeofficial",
    "limit": 1
  }
}
```

## 주의사항

- The board is rebuilt daily. snapshot_at tells you when.
- With a brand and no scope, the board opens in the brand's top category, not all.
- me and lookup only come back on the first page (offset=0).

## 관련 도구

- [`solari_insight_instagram_ranking_posts`](https://finder-dev-pub.bzine.co/docs/tools/insight-instagram-ranking-posts.md?lang=ko)
- [`solari_insight_instagram_ranking_find`](https://finder-dev-pub.bzine.co/docs/tools/insight-instagram-ranking-find.md?lang=ko)
- [`solari_insight_instagram_ranking_creators`](https://finder-dev-pub.bzine.co/docs/tools/insight-instagram-ranking-creators.md?lang=ko)