# solari insight instagram brand ad posts

> Instagram 브랜드의 광고 포스트예요.

- **CLI**: `solari insight instagram brand ad posts`
- **MCP 도구**: `solari_insight_instagram_brand_ad_posts`
- **권한**: `solari:read` — 로그인한 SOLARI 계정이면 쓸 수 있어요.
- **Required plan**: Free
- **Credit**: 0

브랜드의 광고 포스트를 크리에이터와 함께 보여 줘요.

**언제 쓰나** — 합계가 아니라 포스트 목록이 필요할 때 사용해요.

**무엇이 나오나** — 광고 포스트예요. total이 정확한 건 sort=recent일 때뿐이에요.

## 파라미터

- `username` (string, 필수) — 브랜드 Instagram 사용자명. @는 빼 주세요
- `sort` (enum, 선택, 기본값 "recent") — recent는 기간 전체, engagement는 최근 일부의 순위예요 값: `recent`, `engagement`.
- `months` (integer, 선택, ≥ 1) — 몇 달 전까지 볼지
- `limit` (integer, 선택, ≥ 1) — 한 페이지에 몇 개까지
- `offset` (integer, 선택, 기본값 0, ≥ 0) — 앞에서 몇 개를 건너뛸지

## 응답

### `Response`

- `items` (object[]) — 광고 포스트예요
- `total` (integer) — sort=recent일 때, 기간 전체의 정확한 개수예요
- `has_more` (boolean) — 다음 페이지가 있는지예요
- `ranking_window` (integer | null) — 참여 순위가 어디까지 봤는지예요. 기간 전체가 아니라 일부만 볼 때 채워져요

### `items[]`

- `id` (uuid) — 포스트 id
- `slug` (string) — Instagram 숏코드
- `text` (string) — 캡션
- `posted_at` (timestamp) — 게시 시각 (UTC)
- `username / user_id / account_id` (string) — 작성한 크리에이터예요
- `like_count / comment_count / play_count` (integer) — 참여
- `media_type` (string) — 포스트 형식
- `media / media_url / thumbnail_url` (string) — 미디어 링크
- `virtual_campaign` (object | null) — 캠페인 묶음이에요. 잡힌 경우에만 와요

## 예시

```console
$ solari insight instagram brand ad posts username=innisfreeofficial limit=2
```

_읽기 편하도록 긴 문자열과 반복되는 배열 항목을 줄였어요._

```json
{
  "items": [
    {
      "id": "01a062a0-2747-72eb-b20d-670cf30f2c96",
      "slug": "DcygG05GrA-",
      "text": "#광고 요즘 부쩍 신경 쓰이기 시작한 모공 고민을 직접 경험해보고 싶어 방문한 이니스프리 레티놀 시카 강의실 무빙 팝업💙\n\n업그레이드된 레티놀 시카 모공 흔적 앰플을 직접 테스트해볼 수 있을 뿐 아니라, 제품을 알아보고 체험할 수 있는 다양한 프로그램과 이벤트가 마련되어 있어 더욱 재미있게 둘러볼 수 있었어요.\n\n특히 오늘 방문했을 때는 정말 많은 분들이 찾아와서 놀랐는데요. 대기 줄이 길게 …",
      "posted_at": "2026-09-02T14:56:19Z",
      "virtual_campaign": null,
      "username": "_mini_mming",
      "user_id": "018caf92-e08a-78a2-b9c3-59f6f5740182",
      "profile_picture_url": null,
      "like_count": 384,
      "comment_count": 4,
      "thumbnail_url": null,
      "media_url": null,
      "media": [],
      "media_type": "post",
      "account_id": "018caf92-e08a-78a2-b9c3-59f6f5740182"
    },
    "… 1 more"
  ],
  "total": 405,
  "has_more": true,
  "ranking_window": null
}
```

## MCP 호출로 쓰면

```json
{
  "name": "solari_insight_instagram_brand_ad_posts",
  "arguments": {
    "username": "innisfreeofficial",
    "limit": 2
  }
}
```

## 주의사항

- 사용자명을 넣어요. 없는 사용자명이면 404예요.
- sort=engagement는 최근 일부만 순위를 매겨요. ranking_window가 어디까지 봤는지 알려 줘요.

## 관련 도구

- [`solari_insight_instagram_brand_ad_stats`](https://solari.sh/docs/tools/insight-instagram-brand-ad-stats.md?lang=ko)
- [`solari_insight_instagram_account_ad_posts`](https://solari.sh/docs/tools/insight-instagram-account-ad-posts.md?lang=ko)