# solari instagram content trend clusters

> The SOLARI trend digest — recent content grouped into named themes.

- **CLI**: `solari instagram content trend clusters`
- **MCP tool**: `solari_instagram_content_trend_clusters`
- **Access**: `solari:read` — Works with any signed-in SOLARI account.

The SOLARI trend digest: recent content trend clusters for a region with cluster metadata and member posts, optionally reranked by brand affinity when a brand account_id or username is supplied. Works with any signed-in SOLARI account.

**When to use it** — Reading the shape of the moment rather than individual posts.

**What comes back** — Named clusters with size, movement, and member post previews.

## Parameters

- `region` (string, optional, default "KR") — Region code such as KR, JP, or US.
- `since_days` (integer, optional, default 7, 1–90) — Lookback window in days for trending clusters, between 1 and 90.
- `limit` (integer, optional, ≥ 1) — Maximum trend clusters returned, default 20. Values above 24 are clamped to 24.
- `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)$) — Optional brand account_id (SOLARI account UUID) for brand-affinity reranking.
- `username` (string, optional, ≤ 64 chars) — Optional brand Instagram handle for brand-affinity reranking. Ignored when account_id is set.
- `brand_aware` (boolean, optional, default true) — Rerank clusters by brand affinity when account_id is provided.

## 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 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_instagram_content_trend_clusters",
  "arguments": {
    "region": "KR",
    "since_days": 7,
    "limit": 2
  }
}
```

## Notes

- A heavy call — the gateway allows it 120 seconds.
- since_days runs 1–90; limit is clamped at 24.
- Supplying a brand turns on brand_aware reranking. Set brand_aware=false to keep the raw ordering.

## Related tools

- [`solari_instagram_content_trending`](https://solari.sh/docs/tools/instagram-content-trending.md)
- [`solari_instagram_content_rising`](https://solari.sh/docs/tools/instagram-content-rising.md)