# solari instagram account ad posts

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

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

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_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)$) — account_id of the creator (SOLARI account UUID). Provide this or username.
- `username` (string, optional, ≤ 64 chars) — Instagram handle, with or without a leading @. Ignored when account_id is set.
- `months` (integer, optional, ≥ 1) — Lookback window in months, default 3. Values above 24 are clamped to 24.
- `limit` (integer, optional, ≥ 1) — Items per page, default 50. Values above 200 are clamped to 200.
- `offset` (integer, optional, default 0, ≥ 0) — Pagination offset, default 0.
- `target` (string, optional, ≤ 64 chars) — Optional target-brand filter: its account_id (SOLARI account UUID) or Instagram handle.

## Response

### `Response`

- `account_id / username` (string) — The resolved creator.
- `months` (integer) — Lookback window applied.
- `total` (integer) — Total rows.
- `has_more` (boolean) — Whether another page exists.
- `items` (object[]) — Post–brand pairs.

### `items[]`

- `post_id / slug / url` (string) — Post identifiers and public link.
- `post_type` (string) — reel, video, photo, or carousel.
- `posted_at` (timestamp) — Publication time (UTC).
- `text` (string) — Caption text.
- `like_count / comment_count / play_count` (integer) — Engagement snapshot.
- `media_count` (integer) — Number of medias.
- `is_paid_partnership` (boolean | null) — Instagram's paid-partnership label.
- `target_account_id / target_username` (string) — The brand this row is attributed to.

## Example

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

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

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

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

- [`solari_instagram_account_collabs`](https://solari.sh/docs/tools/instagram-account-collabs.md)
- [`solari_instagram_brand_ad_posts`](https://solari.sh/docs/tools/instagram-brand-ad-posts.md)
