# solari insight instagram brand ad posts

> Instagram 브랜드의 광고 게시물.

- **CLI**: `solari insight instagram brand ad posts`
- **MCP 도구**: `solari_insight_instagram_brand_ad_posts`
- **권한**: `solari:read`
- **이용 가능 플랜**: 무료 체험 · Plus · Pro · Enterprise
- **크레딧**: 1

브랜드의 광고 게시물을 크리에이터 정보와 함께 보여 줍니다.

**언제 쓰나요** — 합계만이 아니라 게시물 자체가 필요할 때.

**돌려주는 값** — 광고 게시물. 합계는 sort=recent일 때만 정확합니다.

## 파라미터

- `username` (string, 필수) — 브랜드의 Instagram 사용자 이름. @는 빼고 넣으세요.
- `sort` (enum, 선택, 기본값 "recent") — recent는 기간 전체를 훑습니다. engagement는 최근 일부만 순위를 매깁니다. 값: `recent`, `engagement`.
- `months` (integer, 선택, 기본값 3, 1–24) — 몇 개월 전까지 볼지.
- `limit` (integer, 선택, 기본값 50, 1–200) — 한 페이지에 가져올 게시물 수.
- `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 shortcode.
- `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) — 캠페인 묶음. 캠페인을 찾았을 때만 있습니다.
- `assets` (object[]) — 미디어 파일 목록(순서대로). 파일마다 asset_url, media_type, video_duration이 있습니다.
- `assets[].asset_url` (string | null) — 원본 크기 이미지나 영상을 바로 내려받는 링크. 저장된 파일이 없으면 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
  }
}
```

## 주의사항

- username을 넣으세요. 없는 username이면 404가 나옵니다.
- sort=engagement는 최근 일부 게시물만 순위를 매깁니다. 얼마나 거슬러 봤는지는 ranking_window에 나옵니다.
- likes_hidden이 true면 like_count를 쓰지 마세요. 작성자가 좋아요를 숨겨서 null이거나 실제 값이 아닐 수 있습니다.

## 관련 도구

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