# solari instagram content trending

> Instagram posts trending right now in a region.

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

Instagram posts currently trending in the region, enriched with creator profile fields. Supports cursor pagination via next_cursor from the previous response. Optionally personalizes ranking with a brand account_id or username. Works with any signed-in SOLARI account. Use solari_instagram_content_rising for velocity-led accelerating posts instead.

**When to use it** — "What's working at the moment?" For velocity rather than volume, use content rising.

**What comes back** — Trending posts enriched with author profile fields, paged by cursor.

## Parameters

- `region` (string, optional, default "KR") — Region code such as KR, JP, or US.
- `limit` (integer, optional, ≥ 1) — Maximum posts per page, default 20. Values above 50 are clamped to 50.
- `cursor` (string, optional) — Opaque pagination cursor from the previous response's next_cursor.
- `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 personalization.
- `username` (string, optional, ≤ 64 chars) — Optional brand Instagram handle for brand-affinity personalization. Ignored when account_id is set.

## Response

### `Response`

- `items` (object[]) — Trending posts.
- `total_count` (integer) — Size of the feed.
- `region` (string) — Region applied.
- `content_type` (string) — Feed kind tag.
- `next_cursor` (string | null) — Pass this back as cursor for the next page.

### `items[]`

- `post_id` (uuid) — SOLARI post id. Feed it straight into the other content tools.
- `slug` (string) — Instagram shortcode — the segment after /p/ or /reel/ in a public URL.
- `author_id` (uuid) — account_id of the authoring account.
- `username` (string) — Author handle.
- `full_name` (string | null) — Profile display name.
- `profile_pic_url` (string | null) — Profile picture URL.
- `follower_count` (integer | null) — Author follower count at snapshot time.
- `region` (string | null) — Region code assigned to the author.
- `posted_at` (timestamp) — Publication time (UTC).
- `media_type` (string) — image, video, or carousel.
- `play_count` (integer | null) — Video plays. null for image posts.
- `like_count` (integer | null) — Likes at snapshot time.
- `text` (string | null) — Caption text.
- `media_url` (string) — Original media URL.
- `thumbnail_url` (string) — Thumbnail URL.
- `score` (number | null) — Feed ranking score. Comparable only within one response.
- `efficiency_score` (number | null) — Performance relative to the author's follower count.
- `est_percentile` (number | null) — Estimated percentile within the region, 0–1.
- `total_views_3m` (integer | null) — Author's cumulative views over the last 3 months.
- `median_views_3m` (integer | null) — Author's median views over the last 3 months.
- `recent_collab_brands` (string[]) — Brands the author has collaborated with recently.
- `item_type` (string) — Item kind tag; post in the content feeds.
- `content_source` (string | null) — Which pipeline surfaced this item.
- `is_saved` (boolean | null) — Whether the item is saved in the SOLARI app.
- `updated_at` (timestamp | null) — When the metric snapshot was last refreshed.

## Example

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

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

```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=="
}
```

## As an MCP call

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

## Notes

- Supplying a brand account_id or handle personalises the ranking by brand affinity.
- Pagination is by cursor, not offset — feed next_cursor into the next call.

## Related tools

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