# solari insight instagram content trend clusters

> Instagram trends grouped by theme.

- **CLI**: `solari insight instagram content trend clusters`
- **MCP tool**: `solari_insight_instagram_content_trend_clusters`
- **Access**: `solari:read` — Works with any signed-in SOLARI account.
- **Required plan**: Free
- **Credit**: 0

A trend digest for the region you set: named themes with size, movement, and a few member posts.

**When to use it** — When you want the shape of the moment, not a list of posts.

**What comes back** — Named clusters with a preview of member posts.

## Parameters

- `region` (string, optional, default "KR") — Country code such as KR or JP.
- `since_days` (integer, optional, default 7, 1–90) — How many days back to look.
- `limit` (integer, optional, ≥ 1) — How many clusters to return.
- `account_id` (string, optional, 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)$) — Brand account_id to rank clusters for the brand.
- `username` (string, optional, ≤ 64 chars) — Brand username to rank clusters for the brand. Ignored when account_id is set.
- `brand_aware` (boolean, optional, default true) — Rank clusters for the brand. On by default when a brand is set.

## Response

### `Response`

- `success` (boolean) — Whether the digest was generated.
- `trend_count` (integer) — Clusters returned.
- `header_text` (string) — Digest headline.
- `region / since_days` (string · integer) — Region and lookback applied.
- `brand_aware` (boolean) — Whether brand-affinity reranking was requested.
- `als_applied` (boolean) — Whether the affinity model actually ran.
- `trends` (object[]) — The clusters.

### `trends[]`

- `cluster_id` (string) — Cluster id.
- `name` (string) — Cluster name.
- `bullets` (string[]) — Sentences describing the cluster.
- `count` (integer) — Member posts.
- `count_delta` (integer) — Change in member posts vs. the previous period.
- `growth_pct` (number) — Growth rate, percent.
- `avg_play_delta` (number) — Change in average plays.
- `distinct_creators` (integer) — Creators contributing to the cluster.
- `creator_delta` (integer) — Change in creator count.
- `is_new` (boolean) — Whether the cluster first appeared this period.
- `member_thumbnails` (object[]) — Thumbnail previews of member posts.

## Example

```console
$ solari insight instagram content trend clusters region=KR since_days=7 limit=2
```

_Long strings and repeated array entries are trimmed for readability._

```json
{
  "success": true,
  "trend_count": 2,
  "header_text": "최근 7일 인기 트렌드 2개 (브랜드 컨텍스트 없음)",
  "brand_aware": true,
  "als_applied": false,
  "region": "KR",
  "since_days": 7,
  "directive": null,
  "trends": [
    {
      "cluster_id": "01a05857-7727-74d8-8da5-4e95981aca8d",
      "name": "GV90의 미래형 하이테크 기능",
      "bullets": [
        "화면이 회전하거나 시트가 뒤로 돌아가는 등 물리적으로 변형되는 자동차 내부 장치들을 직접 시연함",
        "… 1 more"
      ],
      "count": 7,
      "count_delta": 0,
      "growth_pct": 0,
      "avg_play_delta": 0,
      "creator_delta": 0,
      "distinct_creators": 3,
      "is_new": false,
      "early_zone_creator_count": null,
      "early_zone_creator_ratio": null,
      "als_member_count": null,
      "mean_als_score": null,
      "annotation": null,
      "group": null,
      "member_thumbnails": [
        {
          "post_id": "01a030df-c4b3-739c-9214-44b3b9463c7b",
          "thumbnail_url": "https://bzine.co/cdn-cgi/media/width=480,mode=frame,time=100ms/https://smr-images-c.bzine.co/users/018cb4c9-da89-7b02-8efd-53ccb65c26c9/posts/01a030df-c4b3-739c-9214-44b3b9463c7b/medias/01a030df-c7c3-788e-8775-1096728e07 …",
          "slug": "DcP6jgRMTRv",
          "username": "sol.bpd",
          "media_url": "https://smr-images-c.bzine.co/users/018cb4c9-da89-7b02-8efd-53ccb65c26c9/posts/01a030df-c4b3-739c-9214-44b3b9463c7b/medias/01a030df-c7c3-788e-8775-1096728e07f2.mp4",
          "media_type": "video",
          "play_count": 1947419,
          "posted_at": "2026-08-20T04:37:17+00:00"
        },
        "… 3 more"
      ]
    },
    "… 1 more"
  ],
  "insights": null,
  "insight_query": null
}
```

## As an MCP call

```json
{
  "name": "solari_insight_instagram_content_trend_clusters",
  "arguments": {
    "region": "KR",
    "since_days": 7,
    "limit": 2
  }
}
```

## Notes

- This call can take up to two minutes.
- Pass a brand to rank clusters for the brand. Set brand_aware=false to keep the raw order.

## Related tools

- [`solari_insight_instagram_content_trending`](https://solari.sh/docs/tools/insight-instagram-content-trending.md)
- [`solari_insight_instagram_content_rising`](https://solari.sh/docs/tools/insight-instagram-content-rising.md)