# solari insight instagram hashtag posts

> 人気の Instagram のハッシュタグを支える投稿。

- **CLI**: `solari insight instagram hashtag posts`
- **MCP ツール**: `solari_insight_instagram_hashtag_posts`
- **アクセス権**: `solari:read`
- **対象プラン**: 無料トライアル · Plus · Pro · Enterprise
- **クレジット**: 1

トレンドの期間内に 1 つのハッシュタグを付けた投稿を、再生数の多い順または新しい順に返します。ランキングの項目を支える実例です。

**どんなときに使うか** — タグのトレンドを生んだ投稿を見たいとき。タグの全期間の履歴が必要な場合は、カタログのタグ検索を使います。

**返される内容** — 投稿の 1 ページ分と、ページ送り用の総数。

## パラメータ

- `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) — 1 ページあたりの投稿数。
- `offset` (integer, 任意, 既定値 0, 0–960) — スキップする投稿数。

## レスポンス

### `Response`

- `tag` (string) — タグ（# なし）。
- `total` (integer) — 期間内にこのタグを付けた投稿数。
- `offset` (integer) — 適用された offset。
- `items` (object[]) — 投稿。

### `items[]`

- `post_id / slug` (string) — 投稿の ID。
- `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_ids をカタログのコンテンツ一括取得に渡します。
- likes_hidden が true のときは like_count を使わないでください。投稿者がいいね数を非表示にしているため、null か、実際の値ではない可能性があります。

## 関連ツール

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