# 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=ko)
- [`solari_instagram_brand_overview`](https://solari.sh/docs/tools/instagram-brand-overview.md?lang=ko)