# solari insight instagram brand ad posts

> Instagram ブランドの広告投稿です。

- **CLI**: `solari insight instagram brand ad posts`
- **MCP ツール**: `solari_insight_instagram_brand_ad_posts`
- **アクセス権**: `solari:read` — サインイン済みの SOLARI アカウントであれば利用できます。
- **Required plan**: Free
- **Credit**: 0

ブランドの広告投稿を、クリエイター付きで返します。

**どんなときに使うか** — 合計ではなく投稿の一覧がほしいときに使います。

**何が返るか** — 広告投稿です。total が正確なのは sort=recent のときだけです。

## パラメータ

- `username` (string, 必須) — ブランドの Instagram ユーザー名。@ は付けません。
- `sort` (enum, 任意, 既定値 "recent") — recent は期間全体、engagement は直近の一部の順位です。 値: `recent`, `engagement`.
- `months` (integer, 任意, ≥ 1) — 何ヶ月前まで見るか。
- `limit` (integer, 任意, ≥ 1) — 1ページあたりの件数。
- `offset` (integer, 任意, 既定値 0, ≥ 0) — 先頭から何件飛ばすか。

## レスポンス

### `Response`

- `items` (object[]) — 広告投稿。
- `total` (integer) — sort=recent のとき、期間全体の正確な件数。
- `has_more` (boolean) — 次のページがあるか。
- `ranking_window` (integer | null) — engagement の順位付けがどこまで見たか。並びが期間全体ではなく一部のときだけ入ります。

### `items[]`

- `id` (uuid) — 投稿 id。
- `slug` (string) — Instagram のショートコード。
- `text` (string) — キャプション。
- `posted_at` (timestamp) — 投稿日時（UTC）。
- `username / user_id / account_id` (string) — 投稿したクリエイター。
- `like_count / comment_count / play_count` (integer) — エンゲージメント。
- `media_type` (string) — 投稿の形式。
- `media / media_url / thumbnail_url` (string) — メディアのリンク。
- `virtual_campaign` (object | null) — キャンペーンのグループ。特定できたときだけ入ります。

## 例

```console
$ solari insight instagram brand ad posts username=innisfreeofficial limit=2
```

_読みやすさのため、長い文字列と繰り返しの配列要素を省略しています。_

```json
{
  "items": [
    {
      "id": "01a062a0-2747-72eb-b20d-670cf30f2c96",
      "slug": "DcygG05GrA-",
      "text": "#광고 요즘 부쩍 신경 쓰이기 시작한 모공 고민을 직접 경험해보고 싶어 방문한 이니스프리 레티놀 시카 강의실 무빙 팝업💙\n\n업그레이드된 레티놀 시카 모공 흔적 앰플을 직접 테스트해볼 수 있을 뿐 아니라, 제품을 알아보고 체험할 수 있는 다양한 프로그램과 이벤트가 마련되어 있어 더욱 재미있게 둘러볼 수 있었어요.\n\n특히 오늘 방문했을 때는 정말 많은 분들이 찾아와서 놀랐는데요. 대기 줄이 길게 …",
      "posted_at": "2026-09-02T14:56:19Z",
      "virtual_campaign": null,
      "username": "_mini_mming",
      "user_id": "018caf92-e08a-78a2-b9c3-59f6f5740182",
      "profile_picture_url": null,
      "like_count": 384,
      "comment_count": 4,
      "thumbnail_url": null,
      "media_url": null,
      "media": [],
      "media_type": "post",
      "account_id": "018caf92-e08a-78a2-b9c3-59f6f5740182"
    },
    "… 1 more"
  ],
  "total": 405,
  "has_more": true,
  "ranking_window": null
}
```

## MCP 呼び出しとして

```json
{
  "name": "solari_insight_instagram_brand_ad_posts",
  "arguments": {
    "username": "innisfreeofficial",
    "limit": 2
  }
}
```

## 注意点

- ユーザー名を渡します。未知のユーザー名は 404 です。
- sort=engagement は直近の一部だけを順位付けします。ranking_window がどこまで見たか教えてくれます。

## 関連ツール

- [`solari_insight_instagram_brand_ad_stats`](https://solari.sh/docs/tools/insight-instagram-brand-ad-stats.md?lang=ja)
- [`solari_insight_instagram_account_ad_posts`](https://solari.sh/docs/tools/insight-instagram-account-ad-posts.md?lang=ja)