# solari insight instagram hashtag posts

> Posts behind one trending Instagram hashtag.

- **CLI**: `solari insight instagram hashtag posts`
- **MCP ツール**: `solari_insight_instagram_hashtag_posts`
- **アクセス権**: `solari:read` — トライアルを含むすべての SOLARI プランで利用できます。成功した呼び出し 1 回につき 1 クレジットです。
- **対象プラン**: Any paid plan or trial
- **クレジット**: 1

Posts carrying one hashtag inside a trend window, most viewed or newest first — the examples behind a leaderboard entry.

**どんなときに使うか** — When you want the posts that drove a tag's trend. For a tag's full history, use catalog tag search.

**何が返るか** — One page of posts, with a total for paging.

## パラメータ

- `tag` (string, 必須, ≤ 100 chars) — Hashtag, with or without #.
- `region` (enum, 任意, 既定値 "KR") — KR or JP. 値: `KR`, `JP`.
- `days` (integer, 任意, 既定値 30) — 7, 30, or 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)$) — Brand account_id. Keeps the same lens as the leaderboard.
- `brand_username` (string, 任意, ≤ 64 chars) — Brand username. Ignored when brand_account_id is set.
- `sort` (enum, 任意, 既定値 "views") — views for most viewed first, recent for newest first. 値: `views`, `recent`.
- `limit` (integer, 任意, ≥ 1) — How many posts per page.
- `offset` (integer, 任意, 既定値 0, 0–960) — How many posts to skip.

## レスポンス

### `Response`

- `tag` (string) — The tag, without #.
- `total` (integer) — Posts with the tag in the window.
- `offset` (integer) — Offset applied.
- `items` (object[]) — The posts.

### `items[]`

- `post_id / slug` (string) — Post identifiers.
- `account_id / username` (string) — Author.
- `posted_at` (timestamp) — Published at.
- `play_count / like_count` (integer) — Views and likes.

## 例

```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
  }
}
```

## 注意点

- Paging stops at offset 960.
- Pass post_ids to catalog content batch for captions and media.

## 関連ツール

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