# solari insight instagram ranking find

> 브랜드·크리에이터 순위표에서 계정 하나의 순위를 찾습니다.

- **CLI**: `solari insight instagram ranking find`
- **MCP 도구**: `solari_insight_instagram_ranking_find`
- **권한**: `solari:read`
- **이용 가능 플랜**: 무료 체험 · Plus · Pro · Enterprise
- **크레딧**: 1

Instagram 계정 하나의 순위를 알려 줍니다. 브랜드인지 크리에이터인지 몰라도 됩니다. 계정이 올라 있는 순위표마다, 계정이 속한 모든 카테고리의 순위와 상위 퍼센트를 돌려줍니다.

**언제 쓰나요** — "이 계정은 몇 위야?"나 "협찬이 아닌 콘텐츠 성과는 어때?"를 묻는데 어느 순위표인지 모를 때.

**돌려주는 값** — 브랜드 쪽과 크리에이터 쪽 결과. 계정이 그 순위표에 없으면 해당 쪽은 null입니다.

## 파라미터

- `username` (string, 필수, ≤ 64 chars) — Instagram username. @는 붙여도 되고 빼도 됩니다.
- `region` (enum, 선택, 기본값 "KR") — KR, JP, US 중 하나. 크리에이터 순위표는 KR과 JP만 있습니다. 값: `KR`, `JP`, `US`.
- `days` (integer, 선택, 기본값 30) — 30 또는 90.

## 응답

### `Response`

- `username` (string) — 찾은 핸들.
- `region / days` (string · integer) — 적용된 설정.
- `sort` (string) — 항상 plays(총 조회수).
- `brand` (object | null) — 브랜드 순위표에서의 위치.
- `creator` (object | null) — 크리에이터 순위표에서의 위치.

### `brand · creator`

- `account` (object) — account_id, username, full_name, follower_count.
- `row` (object | null) — 전체 순위 행. 해당 순위 도구와 필드가 같고, 비협찬 구분 값(organic_post_count, organic_total_plays, organic_median_plays, sponsored_share)도 들어 있습니다.
- `positions` (object[]) — 순위에 오른 카테고리마다 항목이 하나씩 있습니다.
- `positions[].scope / rank / total / top_pct` (string · integer · number) — 카테고리, 순위, 순위에 오른 수, 상위 퍼센트(최소 0.1).
- `positions[].share` (number | null) — 크리에이터 쪽만. 크리에이터 게시물 중 이 카테고리의 비중.
- `min_posts / min_followers` (integer) — 계정이 빠지지 않도록 쓴 가장 느슨한 필터.
- `list_kind` (string) — 크리에이터 쪽만. creator 또는 magazine.
- `snapshot_at` (timestamp | null) — 순위표를 만든 시각.

## 예시

```console
$ solari insight instagram ranking find username=innisfreeofficial region=KR
```

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

```json
{
  "username": "innisfreeofficial",
  "region": "KR",
  "days": 30,
  "sort": "plays",
  "brand": {
    "account": {
      "account_id": "018cabce-14cc-7544-8890-7811ec33ef74",
      "user_id": "018cabce-14cc-7544-8890-7811ec33ef74",
      "username": "innisfreeofficial",
      "full_name": "INNISFREE | 이니스프리",
      "follower_count": 847619
    },
    "min_posts": 1,
    "row": {
      "account_id": "018cabce-14cc-7544-8890-7811ec33ef74",
      "rank": 7,
      "user_id": "018cabce-14cc-7544-8890-7811ec33ef74",
      "username": "innisfreeofficial",
      "post_count": 1204,
      "total_plays": 38920400,
      "median_plays": 14120,
      "sponsored_post_count": 402,
      "sponsored_total_plays": 17610200,
      "organic_median_plays": 11900,
      "categories": [
        "BEAUTY/SKINCARE"
      ],
      "organic_post_count": 802,
      "organic_total_plays": 21310200,
      "sponsored_share": 0.3339
    },
    "positions": [
      {
        "scope": "all",
        "rank": 7,
        "total": 21483,
        "top_pct": 0.1
      },
      {
        "scope": "d1:BEAUTY",
        "rank": 4,
        "total": 3120,
        "top_pct": 0.1
      },
      {
        "scope": "d2:BEAUTY/SKINCARE",
        "rank": 2,
        "total": 1843,
        "top_pct": 0.1
      }
    ],
    "snapshot_at": "2026-09-22T19:04:11.482913+00:00"
  },
  "creator": null
}
```

## MCP 호출

```json
{
  "name": "solari_insight_instagram_ranking_find",
  "arguments": {
    "username": "innisfreeofficial",
    "region": "KR"
  }
}
```

## 주의사항

- 가장 느슨한 필터를 씁니다. 그래서 여기 순위가 필터를 더 엄격하게 건 목록보다 높게 나올 수 있습니다.

## 관련 도구

- [`solari_insight_instagram_ranking_brands`](https://clip-pub.bzine.co/docs/tools/insight-instagram-ranking-brands.md?lang=ko)
- [`solari_insight_instagram_ranking_creators`](https://clip-pub.bzine.co/docs/tools/insight-instagram-ranking-creators.md?lang=ko)