# solari instagram brand collaborator posts

> One brand plus up to 100 creators, hydrated in a single call.

- **CLI**: `solari instagram brand collaborator posts`
- **MCP tool**: `solari_instagram_brand_collaborator_posts`
- **Access**: `solari:read` — Works with any signed-in SOLARI account.

For one brand and up to 100 creator account_ids, returns each creator's sponsored posts targeting that brand — per creator: post_count, reels_count, images_count, follower_count, and the posts themselves (slug, caption, posted_at, like/comment counts) — sorted by total engagement. All-time history, one call instead of one per creator. Get creator account_ids from solari_instagram_brand_top_collaborators or solari_instagram_brand_overview. Identify the brand by account_id (SOLARI account UUID) or by username (Instagram handle); an unknown reference returns a not-found error. Works with any signed-in SOLARI account.

**When to use it** — Replacing one call per creator. Covers all-time history rather than a recent window.

**What comes back** — Per-creator rollups and the posts themselves, sorted by total engagement.

## Parameters

- `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 (SOLARI account UUID). Provide this or username.
- `username` (string, optional, ≤ 64 chars) — Brand Instagram handle, with or without a leading @. Ignored when account_id is set.
- `account_ids` (uuid[], required, 1–100 items, uuid) — Creator account_ids (SOLARI account UUIDs) to hydrate, at most 100 per call.

## Response

### `Response`

- `(top level)` (object[]) — An array of creators — this response has no envelope object.

### `[]`

- `user_id` (uuid) — Creator account_id.
- `username / full_name` (string) — Handle and display name.
- `follower_count` (integer) — Follower count.
- `post_count` (integer) — Posts targeting this brand.
- `reels_count / images_count` (integer) — Breakdown by format.
- `posts` (object[]) — The posts: id, slug, text, posted_at, like_count, comment_count, play_count.
- `like_count_avg / comment_count_avg` (number | null) — Mean engagement, when computed.

## Example

```console
$ solari instagram brand collaborator posts username=innisfreeofficial account_ids='["0195474c-8ee3-7690-a385-71b2913e31b5","018ecc75-55d8-70a7-a348-d370aa504ed9"]'
```

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

```json
[
  {
    "user_id": "018ecc75-55d8-70a7-a348-d370aa504ed9",
    "username": "beinny_motd",
    "full_name": "베이니 BEINNY",
    "post_count": 29,
    "follower_count": 205754,
    "reels_count": 1,
    "images_count": 28,
    "posts": [
      {
        "id": "019c98bc-a666-717d-a5fe-ea96f1345042",
        "slug": "ByVKkIbnQ8S",
        "text": "#이니스프리 에서 새롭게 출시된 #구름블러틴트 ☁️💓\n비비드 코튼 잉크 블러버젼이에용\n.\n요즘 이런 블러틴트류 많이 출시돼서 넘 행복해요🥺💛\n이니스프리 블러틴트는 보송보송한 마무리지만 꽤 촉촉하고 가볍게 발리더라구요! 발림성 넘 좋았어요✨\n총 8가지 컬러인데 그중 제 맘에 드는 4가지 컬러는 입술에 발색해서 보여드려용 :) 특히 로즈+핑크 섞인듯한 2호 #로제핑크 완전 추천👍🏻✨\n가격은 9, …",
        "posted_at": "2019-06-05T14:02:19Z",
        "virtual_campaign": null,
        "like_count": 2399,
        "comment_count": 20,
        "play_count": null,
        "username": "beinny_motd",
        "user_id": "018ecc75-55d8-70a7-a348-d370aa504ed9"
      },
      "… 10 more"
    ],
    "like_count_avg": null,
    "comment_count_avg": null,
    "synced_at": null
  },
  "… 1 more"
]
```

## As an MCP call

```json
{
  "name": "solari_instagram_brand_collaborator_posts",
  "arguments": {
    "username": "innisfreeofficial",
    "account_ids": [
      "0195474c-8ee3-7690-a385-71b2913e31b5",
      "018ecc75-55d8-70a7-a348-d370aa504ed9"
    ]
  }
}
```

## Notes

- account_ids accepts a JSON array or a comma-separated list. Up to 100 per call.
- Covers full history, with no month window.

## Related tools

- [`solari_instagram_brand_top_collaborators`](https://solari.sh/docs/tools/instagram-brand-top-collaborators.md)
- [`solari_instagram_brand_overview`](https://solari.sh/docs/tools/instagram-brand-overview.md)