# solari instagram brand ad stats

> Exact ad volume for a brand's recent window.

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

Exact sponsored-post and collaborating-creator counts for a brand's recent window, plus a bounded play-count sum. Use this for accurate ad-volume figures since solari_instagram_brand_overview ID lists are capped; for the underlying row-level posts use solari_instagram_brand_ad_posts. Takes the brand's Instagram handle (no @). Works with any signed-in SOLARI account.

**When to use it** — Questions answered by a number — "how many ads did this brand run?". The brand overview id lists are capped and must not be counted.

**What comes back** — Sponsored-post count, collaborating-creator count, and a bounded play-count sum.

## Parameters

- `username` (string, required) — Brand Instagram handle without the leading @.

## Response

### `Response`

- `total_ad_posts` (integer) — Sponsored posts in the window. Exact.
- `unique_creator_count` (integer) — Distinct collaborating creators.
- `total_play_count` (integer) — Sum of plays.
- `play_count_covered_posts` (integer) — Posts the play sum actually covers. Lower than total_ad_posts means the sum is a lower bound.
- `window_months` (integer) — Length of the window in months.

## Example

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

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

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

## As an MCP call

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

## Notes

- Takes a handle only.
- For the underlying rows, use brand ad posts.

## Related tools

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