# solari insight instagram hashtag posts

> 인기 Instagram 해시태그 하나를 단 게시물.

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

트렌드 기간 안에 해시태그 하나를 단 게시물입니다. 조회수가 많은 순서나 최신순으로 받습니다. 순위표 항목 뒤에 있는 실제 사례입니다.

**언제 쓰나요** — 태그 트렌드를 만든 게시물을 보고 싶을 때. 태그의 전체 기록이 필요하면 카탈로그 태그 검색을 쓰세요.

**돌려주는 값** — 게시물 한 페이지. 페이지를 넘길 때 쓰는 total도 함께 옵니다.

## 파라미터

- `tag` (string, 필수, ≤ 100 chars) — 해시태그. #는 붙여도 되고 빼도 됩니다.
- `region` (enum, 선택, 기본값 "KR") — KR 또는 JP. 값: `KR`, `JP`.
- `days` (integer, 선택, 기본값 30) — 7, 30, 90 중 하나.
- `brand_account_id` (string, 선택, uuid, pattern ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$) — 브랜드 account_id. 순위표와 같은 기준을 유지합니다.
- `brand_username` (string, 선택, ≤ 64 chars) — 브랜드 username. brand_account_id가 있으면 무시합니다.
- `sort` (enum, 선택, 기본값 "views") — 조회수 많은 순은 views, 최신순은 recent. 값: `views`, `recent`.
- `limit` (integer, 선택, 기본값 12, 1–24) — 한 페이지에 받을 게시물 수.
- `offset` (integer, 선택, 기본값 0, 0–960) — 건너뛸 게시물 수.

## 응답

### `Response`

- `tag` (string) — 태그. #는 뺍니다.
- `total` (integer) — 기간 안에 이 태그를 단 게시물 수.
- `offset` (integer) — 적용된 offset.
- `items` (object[]) — 게시물 목록.

### `items[]`

- `post_id / slug` (string) — 게시물 식별자.
- `account_id / username` (string) — 작성자.
- `posted_at` (timestamp) — 게시 시각.
- `play_count / like_count` (integer) — 조회수와 좋아요 수.

## 예시

```console
$ solari insight instagram hashtag posts tag=가을메이크업 region=KR days=30 limit=2
```

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

```json
{
  "tag": "가을메이크업",
  "total": 1204,
  "offset": 0,
  "items": [
    {
      "post_id": "01a05575-7c9b-7232-8519-4a38fa061389",
      "user_id": "018ecc75-55d8-70a7-a348-d370aa504ed9",
      "username": "beinny_motd",
      "slug": "DcpugJ2kzv8",
      "posted_at": "2026-08-30T05:08:56+00:00",
      "play_count": 0,
      "like_count": 878,
      "account_id": "018ecc75-55d8-70a7-a348-d370aa504ed9"
    },
    "… 1 more"
  ]
}
```

## MCP 호출

```json
{
  "name": "solari_insight_instagram_hashtag_posts",
  "arguments": {
    "tag": "가을메이크업",
    "region": "KR",
    "days": 30,
    "limit": 2
  }
}
```

## 주의사항

- offset은 최대 960까지 넘길 수 있습니다.
- 캡션과 미디어가 필요하면 post_id를 카탈로그 콘텐츠 일괄 조회에 넘기세요.
- likes_hidden이 true면 like_count를 쓰지 마세요. 작성자가 좋아요를 숨겨서 null이거나 실제 값이 아닐 수 있습니다.

## 관련 도구

- [`solari_insight_instagram_hashtag_detail`](https://clip-pub.bzine.co/docs/tools/insight-instagram-hashtag-detail.md?lang=ko)
- [`solari_catalog_instagram_tag_search`](https://clip-pub.bzine.co/docs/tools/catalog-instagram-tag-search.md?lang=ko)
- [`solari_catalog_instagram_content_batch`](https://clip-pub.bzine.co/docs/tools/catalog-instagram-content-batch.md?lang=ko)