# solari insight instagram brand ad stats

> Instagram ブランドの広告規模が数字で分かります。

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

ブランドの直近広告を正確な数字で返します。広告投稿数、クリエイター数、再生数の合計です。

**どんなときに使うか** — 答えが数字のときに使います。brand overview の id 一覧は数えません。

**何が返るか** — 広告投稿数、クリエイター数、再生数の合計です。

## パラメータ

- `username` (string, 必須) — ブランドの Instagram ユーザー名。@ は付けません。

## レスポンス

### `Response`

- `total_ad_posts` (integer) — 期間内の広告投稿数。正確な値です。
- `unique_creator_count` (integer) — コラボしたクリエイターのユニーク数。
- `total_play_count` (integer) — 再生数の合計。
- `play_count_covered_posts` (integer) — 再生数の合計に入っている投稿数。total_ad_posts より少ないときは下限です。
- `window_months` (integer) — 期間の長さ（月数）。

## 例

```console
$ solari insight instagram brand ad stats username=innisfreeofficial
```

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

```json
{
  "total_ad_posts": 405,
  "unique_creator_count": 360,
  "total_play_count": 27357941,
  "play_count_covered_posts": 405,
  "window_months": 3
}
```

## MCP 呼び出しとして

```json
{
  "name": "solari_insight_instagram_brand_ad_stats",
  "arguments": {
    "username": "innisfreeofficial"
  }
}
```

## 注意点

- ユーザー名を渡します。account_id は使えません。

## 関連ツール

- [`solari_insight_instagram_brand_ad_posts`](https://solari.sh/docs/tools/insight-instagram-brand-ad-posts.md?lang=ja)
- [`solari_insight_instagram_brand_overview`](https://solari.sh/docs/tools/insight-instagram-brand-overview.md?lang=ja)