# solari insight instagram ranking posts

> 순위 행 뒤에 있는 상위 게시물.

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

순위표 한 행 뒤에 있는 성과가 가장 좋은 게시물입니다. 브랜드나 크리에이터 수치의 근거가 됩니다. 게시물마다 협찬 여부가 표시되고, kind=organic이면 비협찬 게시물만 남깁니다.

**언제 쓰나요** — 브랜드나 크리에이터 순위를 본 뒤, 한 행의 수치가 어디서 나왔는지 보고 싶을 때.

**돌려주는 값** — 작성자 정보가 붙은 상위 게시물. 성과가 좋은 순서입니다.

## 파라미터

- `board` (enum, 필수) — brand 또는 creator. 행이 나온 순위표입니다. 값: `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.
- `region` (enum, 선택, 기본값 "KR") — 목록과 같은 시장. 값: `KR`, `JP`, `US`.
- `days` (integer, 선택, 기본값 30) — 목록과 같은 기간. 30 또는 90.
- `scope` (string, 선택, ≤ 120 chars) — 크리에이터 순위표만. 목록에서 쓴 것과 같은 scope.
- `kind` (enum, 선택, 기본값 "all") — all, 협찬 게시물만 보는 sponsored, 비협찬 게시물만 보는 organic 중 하나. 값: `all`, `sponsored`, `organic`.
- `limit` (integer, 선택, 기본값 6, 1–12) — 받을 게시물 수.

## 응답

### `Response`

- `account_id` (uuid) — 행의 계정.
- `kind` (string) — all, sponsored, organic 중 하나.
- `checked_top_posts` (integer) — kind=organic일 때만. 행의 상위 게시물 중 확인한 개수.
- `items` (object[]) — 상위 게시물. 성과가 좋은 순서입니다.

### `items[]`

- `post_id / slug` (string) — 게시물 식별자.
- `posted_at` (timestamp | null) — 게시 시각(UTC).
- `media_type` (string) — image 또는 video.
- `thumbnail_url` (string) — 썸네일 URL.
- `media_url` (string | null) — 미디어 URL. 파일이 저장돼 있지 않으면 null.
- `play_count` (integer | null) — 영상 재생 수.
- `sponsored` (boolean) — 협찬 게시물인지 여부.
- `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
  }
}
```

## 주의사항

- 목록과 같은 region, days, (크리에이터라면) scope를 쓰세요. 다르면 게시물이 수치와 맞지 않습니다.
- 브랜드 순위표에서는 작성자가 대부분 브랜드를 태그하거나 멘션한 크리에이터입니다.
- 행마다 조회수 기준 상위 6개 게시물만 보관합니다. kind=organic은 그중 비협찬 게시물만 돌려주니까 개수가 적거나 비어 있을 수 있습니다.

## 관련 도구

- [`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)
- [`solari_catalog_instagram_content_batch`](https://clip-pub.bzine.co/docs/tools/catalog-instagram-content-batch.md?lang=ko)