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

solari instagram account ad posts

Row-level sponsored posts a creator authored, with the target brand on each row.

MCP tool
solari_instagram_account_ad_posts
CLI
solari instagram account ad posts
Access
solari:readWorks with any signed-in SOLARI account.Works with any signed-in SOLARI account.

Overview

Paginated row-level list of the identified sponsored posts one creator authored, newest first, with the target brand attached to each row — one row per post-brand pair, so a multi-brand post appears once per target. Each item carries post_id, slug and url, post_type, posted_at, caption text, like/comment/play counts, media_count, is_paid_partnership, and target_account_id/target_username. Filter to one brand with target (its account_id or Instagram handle). Widen the lookback with months (default 3, up to 24). Row-level companion to solari_instagram_account_collabs, which groups the same history by brand. Identify the creator 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 — Analysing collaboration history as raw rows. A post tagging several brands appears once per target, so rows are post–brand pairs.

What comes back — Sponsored posts, newest first.

Parameters

account_idstringoptional
account_id of the creator (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
Instagram handle, with or without a leading @. Ignored when account_id is set.≤ 64 chars
monthsintegeroptional
Lookback window in months, default 3. Values above 24 are clamped to 24.≥ 1
limitintegeroptional
Items per page, default 50. Values above 200 are clamped to 200.≥ 1
offsetintegeroptional
Pagination offset, default 0.default 0≥ 0
targetstringoptional
Optional target-brand filter: its account_id (SOLARI account UUID) or Instagram handle.≤ 64 chars

Response

Response

account_id / usernamestring
The resolved creator.
monthsinteger
Lookback window applied.
totalinteger
Total rows.
has_moreboolean
Whether another page exists.
itemsobject[]
Post–brand pairs.

items[]

post_id / slug / urlstring
Post identifiers and public link.
post_typestring
reel, video, photo, or carousel.
posted_attimestamp
Publication time (UTC).
textstring
Caption text.
like_count / comment_count / play_countinteger
Engagement snapshot.
media_countinteger
Number of medias.
is_paid_partnershipboolean | null
Instagram's paid-partnership label.
target_account_id / target_usernamestring
The brand this row is attributed to.

Example

Request

$ solari instagram account ad posts username=beinny_motd months=6 limit=2

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

{
  "account_id": "018ecc75-55d8-70a7-a348-d370aa504ed9",
  "username": "beinny_motd",
  "months": 6,
  "total": 12,
  "has_more": true,
  "items": [
    {
      "post_id": "01a05575-7c9b-7232-8519-4a38fa061389",
      "slug": "DcpugJ2kzv8",
      "url": "https://www.instagram.com/p/DcpugJ2kzv8/",
      "post_type": "carousel",
      "posted_at": "2026-08-30T05:08:56Z",
      "text": "#광고 무겁지 않은 가을 데일리 팔레트 로즈밀크티 . .🫖🤎\n차분하고 미지근한 로즈핑크 팔레트인데\n부드러운 밀크티 무드라서 분위기가 넘 예뻐요..🥺\n\n데이지크에서 올리브영 X 산리오 콜라보\n시티팝 에디션으로 미니섀도우팔레트 4종이 출시되는데\n그 중 자주 추천드렸던 로즈밀크티, 밀크라떼가 있더라구요 !\n\nNEW 컬러 피치레코드, 모브카세트도 출시되어요🤍\n도시의 아침과 저녁 무드를 담은 데일리한 …",
      "like_count": 878,
      "comment_count": 19,
      "play_count": 0,
      "media_count": 15,
      "is_paid_partnership": null,
      "target_account_id": "018cab85-8ef8-7dc9-ab0a-7044d463f65e",
      "target_username": "dasique_official"
    },
    "… 1 more"
  ]
}

As an MCP call

{
  "name": "solari_instagram_account_ad_posts",
  "arguments": {
    "username": "beinny_motd",
    "months": 6,
    "limit": 2
  }
}

Notes

  • target filters to a single brand and accepts either its account_id or its handle.
  • months defaults to 3 and reaches back up to 24 — further than account collabs.
  • To see the same history grouped by brand, use account collabs.

Related tools

Machine-readable: /docs/tools/instagram-account-ad-posts.md