# solari instagram brand ad stats

> ブランドの直近期間における正確な広告ボリューム。

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

ブランドの直近期間における広告投稿数とコラボレーションしたクリエイター数の正確な件数、および範囲が限定された再生数の合計。solari_instagram_brand_overviewのIDリストには上限があるため、正確な広告ボリュームの数値にはこちらをお使いください。行単位の元の投稿にはsolari_instagram_brand_ad_postsをお使いください。ブランドのInstagramハンドル（@なし）を受け取ります。サインイン済みのSOLARIアカウントであれば利用できます。

**どんなときに使うか** — 数値で答える質問のとき。「このブランドは広告をいくつ出したか」など。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 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_instagram_brand_ad_stats",
  "arguments": {
    "username": "innisfreeofficial"
  }
}
```

## 注意点

- 受け付けるのはハンドルのみ。
- 元になった行が必要な場合はbrand ad postsをお使いください。

## 関連ツール

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