← All tools
instagram · brandsolari:readWorks with any signed-in SOLARI account.

solari instagram brand collaborator posts

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

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

Overview

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

Response

Response

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

[]

user_iduuid
Creator account_id.
username / full_namestring
Handle and display name.
follower_countinteger
Follower count.
post_countinteger
Posts targeting this brand.
reels_count / images_countinteger
Breakdown by format.
postsobject[]
The posts: id, slug, text, posted_at, like_count, comment_count, play_count.
like_count_avg / comment_count_avgnumber | null
Mean engagement, when computed.

Example

Request

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

Response · Long strings and repeated array entries are trimmed for readability.

[
  {
    "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

{
  "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

Machine-readable: /docs/tools/instagram-brand-collaborator-posts.md