# solari insight instagram ranking posts

> The top posts behind a ranking row.

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

The best-performing posts behind one leaderboard row — the evidence for a brand's or creator's number. Each post is marked sponsored or not, and kind=organic keeps only the non-sponsored ones.

**언제 쓰나** — After ranking brands or creators, when you want to see what drove a row.

**무엇이 나오나** — Top posts with their authors, best first.

## 파라미터

- `board` (enum, 필수) — brand or creator — the board the row came from. 값: `brand`, `creator`.
- `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)$) — account_id from the ranking row.
- `region` (enum, 선택, 기본값 "KR") — Same market as the list. 값: `KR`, `JP`, `US`.
- `days` (integer, 선택, 기본값 30) — Same window as the list: 30 or 90.
- `scope` (string, 선택, ≤ 120 chars) — Creator board only: the same scope the list used.
- `kind` (enum, 선택, 기본값 "all") — all, sponsored for sponsored posts only, or organic for non-sponsored posts only. 값: `all`, `sponsored`, `organic`.
- `limit` (integer, 선택, ≥ 1) — How many posts to return.

## 응답

### `Response`

- `account_id` (uuid) — The row's account.
- `kind` (string) — all, sponsored, or organic.
- `checked_top_posts` (integer) — kind=organic only: how many of the row's top posts were checked.
- `items` (object[]) — Top posts, best first.

### `items[]`

- `post_id / slug` (string) — Post identifiers.
- `posted_at` (timestamp | null) — Published at (UTC).
- `media_type` (string) — image or video.
- `thumbnail_url` (string) — Thumbnail URL.
- `media_url` (string | null) — Media URL. Null when the file isn't stored.
- `play_count` (integer | null) — Video plays.
- `sponsored` (boolean) — Whether it's a sponsored post.
- `author` (object) — account_id, username, full_name, follower_count, profile_pic_url.

## 예시

```console
$ solari insight instagram ranking posts board=brand account_id=018cabce-14cc-7544-8890-7811ec33ef74 region=KR limit=2
```

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

```json
{
  "account_id": "018cabce-14cc-7544-8890-7811ec33ef74",
  "kind": "all",
  "items": [
    {
      "post_id": "01a04c73-3ec3-7873-9e84-334c644abfe4",
      "slug": "DckGrZ6vZiU",
      "posted_at": "2026-08-21T10:03:52+00:00",
      "media_type": "video",
      "media_url": null,
      "thumbnail_url": "https://dcr.bzine.co/instagram/posts/DckGrZ6vZiU/thumbnails/m",
      "play_count": 155729,
      "author": {
        "account_id": "0196c474-c96e-71ad-aceb-61af051c81d3",
        "user_id": "0196c474-c96e-71ad-aceb-61af051c81d3",
        "username": "hwitto_",
        "full_name": null,
        "follower_count": 48210,
        "profile_pic_url": "https://dcr.bzine.co/instagram/users/hwitto_/profile-picture"
      },
      "sponsored": true
    },
    "… 1 more"
  ]
}
```

## MCP 호출로 쓰면

```json
{
  "name": "solari_insight_instagram_ranking_posts",
  "arguments": {
    "board": "brand",
    "account_id": "018cabce-14cc-7544-8890-7811ec33ef74",
    "region": "KR",
    "limit": 2
  }
}
```

## 주의사항

- Use the same region, days, and (for creators) scope as the list, or the posts won't match the numbers.
- On the brand board, the authors are mostly creators who tagged or mentioned the brand.
- A row keeps its top 6 posts by views. kind=organic returns the non-sponsored ones among them, so it can come back short or empty.

## 관련 도구

- [`solari_insight_instagram_ranking_brands`](https://solari.sh/docs/tools/insight-instagram-ranking-brands.md?lang=ko)
- [`solari_insight_instagram_ranking_creators`](https://solari.sh/docs/tools/insight-instagram-ranking-creators.md?lang=ko)
- [`solari_catalog_instagram_content_batch`](https://solari.sh/docs/tools/catalog-instagram-content-batch.md?lang=ko)