# solari instagram content trending

> 리전에서 지금 트렌딩 중인 Instagram 포스트.

- **CLI**: `solari instagram content trending`
- **MCP 도구**: `solari_instagram_content_trending`
- **권한**: `solari:read` — 로그인한 SOLARI 계정이면 쓸 수 있어요.

해당 리전에서 현재 트렌딩 중인 Instagram 포스트를 크리에이터 프로필 필드와 함께 반환해요. 이전 응답의 next_cursor를 통한 커서 페이지네이션을 지원해요. 브랜드 account_id 또는 username으로 랭킹을 개인화할 수 있어요. 로그인된 SOLARI 계정이면 누구나 사용할 수 있어요. 속도 기반으로 가속 중인 포스트가 필요하면 solari_instagram_content_rising을 대신 사용하세요.

**언제 쓰나** — "지금 뭐가 먹히고 있나?" 볼륨이 아니라 속도가 필요하면 content rising을 사용하세요.

**무엇이 돌아오나** — 작성자 프로필 필드가 붙은 트렌딩 포스트, 커서로 페이징돼요.

## 파라미터

- `region` (string, 선택, 기본값 "KR") — KR, JP, US 같은 리전 코드.
- `limit` (integer, 선택, ≥ 1) — 페이지당 최대 포스트 수, 기본값 20. 50을 넘는 값은 50으로 잘려요.
- `cursor` (string, 선택) — 이전 응답의 next_cursor에서 받은 불투명(opaque) 페이지네이션 커서.
- `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 (SOLARI 계정 UUID).
- `username` (string, 선택, ≤ 64 chars) — 브랜드 친화도 개인화를 위한 선택적 브랜드 Instagram 핸들. account_id가 지정되면 무시돼요.

## 응답

### `Response`

- `items` (object[]) — 트렌딩 포스트.
- `total_count` (integer) — 피드의 크기.
- `region` (string) — 적용된 리전.
- `content_type` (string) — 피드 종류 태그.
- `next_cursor` (string | null) — 다음 페이지를 요청할 때 cursor로 다시 넘기세요.

### `items[]`

- `post_id` (uuid) — SOLARI post id. 다른 content 툴에 그대로 넣으면 돼요.
- `slug` (string) — Instagram 숏코드 — 공개 URL에서 /p/ 또는 /reel/ 뒤의 구간.
- `author_id` (uuid) — 작성 계정의 account_id.
- `username` (string) — 작성자 핸들.
- `full_name` (string | null) — 프로필 표시 이름.
- `profile_pic_url` (string | null) — 프로필 사진 URL.
- `follower_count` (integer | null) — 스냅샷 시점의 작성자 팔로워 수.
- `region` (string | null) — 작성자에게 할당된 리전 코드.
- `posted_at` (timestamp) — 게시 시각 (UTC).
- `media_type` (string) — image, video, 또는 carousel.
- `play_count` (integer | null) — 영상 재생 수. image 포스트에서는 null.
- `like_count` (integer | null) — 스냅샷 시점의 좋아요 수.
- `text` (string | null) — 캡션 텍스트.
- `media_url` (string) — 원본 미디어 URL.
- `thumbnail_url` (string) — 썸네일 URL.
- `score` (number | null) — 피드 랭킹 점수. 하나의 응답 안에서만 비교 가능해요.
- `efficiency_score` (number | null) — 작성자 팔로워 수 대비 성과.
- `est_percentile` (number | null) — 리전 내 추정 백분위, 0–1.
- `total_views_3m` (integer | null) — 최근 3개월간 작성자의 누적 조회 수.
- `median_views_3m` (integer | null) — 최근 3개월간 작성자의 조회 수 중앙값.
- `recent_collab_brands` (string[]) — 작성자가 최근에 협업한 브랜드.
- `item_type` (string) — 아이템 종류 태그. content 피드에서는 post.
- `content_source` (string | null) — 이 아이템을 노출시킨 파이프라인.
- `is_saved` (boolean | null) — SOLARI 앱에 저장된 아이템인지 여부.
- `updated_at` (timestamp | null) — 지표 스냅샷이 마지막으로 갱신된 시각.

## 예시

```console
$ solari instagram content trending region=KR limit=2
```

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

```json
{
  "items": [
    {
      "item_type": "content",
      "post_id": "01a055fe-d72c-7005-8709-eef67b4be6f0",
      "author_id": "018ecc27-f8e7-7100-9339-bb050ea44a7f",
      "username": "sixpackpiggy",
      "full_name": "Jinmin Park",
      "profile_pic_url": "https://dcr.bzine.co/instagram/users/sixpackpiggy/profile-picture",
      "follower_count": 93442,
      "region": "KR",
      "posted_at": "2026-08-29T02:02:20Z",
      "media_type": "video",
      "play_count": 286749,
      "like_count": null,
      "score": 96.69330916066565,
      "efficiency_score": null,
      "est_percentile": 96.69330916066565,
      "updated_at": "2026-09-03T04:51:42.797111Z",
      "media_url": "https://smr-images-b.bzine.co/users/018ecc27-f8e7-7100-9339-bb050ea44a7f/posts/01a055fe-d72c-7005-8709-eef67b4be6f0/medias/01a055fe-d964-7d73-9a77-d06823a2abc2.mp4",
      "thumbnail_url": "https://bzine.co/cdn-cgi/media/width=480,mode=frame,time=0ms/https://smr-images.bzine.co/users/018ecc27-f8e7-7100-9339-bb050ea44a7f/posts/01a055fe-d72c-7005-8709-eef67b4be6f0/medias/01a055fe-d964-7d73-9a77-d06823a2abc2.m …",
      "slug": "Dcmzs05SAae",
      "text": "How dedicated are you to your Korean skincare? 💅@patinaosaka \n#koreanskincare #osaka #japan #kbeauty #traveling",
      "brand_match_score": null,
      "recent_collab_brands": [],
      "total_views_3m": 1875678,
      "median_views_3m": 57780,
      "is_saved": false,
      "content_source": null
    },
    "… 1 more"
  ],
  "total_count": 213635,
  "region": "KR",
  "content_type": "trending",
  "next_cursor": "eyJhcyI6ICIyMDI2LTA5LTAzVDA1OjIwOjIzLjM4Mzk3NCswMDowMCIsICJzYyI6ICIyMDI2LTA5LTAzVDA0OjQ0OjQ3LjkzNTI1OCswMDowMCIsICJzcCI6ICIwMWEwNTVmZS1mOWIyLTdiNmYtYjY1OS05ZGE1OTM3NjgzMWMifQ=="
}
```

## MCP 호출로 쓰면

```json
{
  "name": "solari_instagram_content_trending",
  "arguments": {
    "region": "KR",
    "limit": 2
  }
}
```

## 주의사항

- 브랜드 account_id 또는 핸들을 넘기면 브랜드 친화도 기준으로 랭킹이 개인화돼요.
- 페이지네이션은 offset이 아니라 커서 방식이에요 — next_cursor를 다음 호출에 넣으세요.

## 관련 도구

- [`solari_instagram_content_rising`](https://solari.sh/docs/tools/instagram-content-rising.md?lang=ko)
- [`solari_instagram_content_trend_clusters`](https://solari.sh/docs/tools/instagram-content-trend-clusters.md?lang=ko)