# solari insight instagram brand ad stats

> Instagram ブランドの広告の量。

- **CLI**: `solari insight instagram brand ad stats`
- **MCP ツール**: `solari_insight_instagram_brand_ad_stats`
- **アクセス権**: `solari:read`
- **対象プラン**: 無料トライアル · Plus · Pro · Enterprise
- **クレジット**: 1

ブランドの最近の広告について、正確な数を返します。タイアップ投稿の件数、クリエイターの数、再生回数の合計です。

**どんなときに使うか** — 答えが数値のとき。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 ではなく username を渡します。

## 関連ツール

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