# solari insight instagram ranking posts

> ランキングの行を支える上位の投稿。

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

ランキングの 1 行を支える、成果の高い投稿。ブランドやクリエイターの数値の根拠になります。各投稿にタイアップかどうかが付き、kind=organic を指定するとタイアップ以外の投稿だけを返します。

**どんなときに使うか** — ブランドやクリエイターのランキングを見たあと、ある行の数値が何によるものか確認したいとき。

**返される内容** — 上位の投稿と投稿者（成果の高い順）。

## パラメータ

- `board` (enum, 必須) — brand または creator。行を取得したランキングです。 値: `brand`, `creator`.
- `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。
- `region` (enum, 任意, 既定値 "KR") — 一覧と同じ市場。 値: `KR`, `JP`, `US`.
- `days` (integer, 任意, 既定値 30) — 一覧と同じ期間。30 または 90。
- `scope` (string, 任意, ≤ 120 chars) — クリエイターランキングのみ。一覧で使ったのと同じ scope。
- `kind` (enum, 任意, 既定値 "all") — all、タイアップ投稿のみの sponsored、タイアップ以外の投稿のみの organic のいずれか。 値: `all`, `sponsored`, `organic`.
- `limit` (integer, 任意, 既定値 6, 1–12) — 返す投稿数。

## レスポンス

### `Response`

- `account_id` (uuid) — 行のアカウント。
- `kind` (string) — all、sponsored、organic のいずれか。
- `checked_top_posts` (integer) — kind=organic の場合のみ。行の上位投稿のうち確認した件数。
- `items` (object[]) — 上位の投稿（成果の高い順）。

### `items[]`

- `post_id / slug` (string) — 投稿の ID。
- `posted_at` (timestamp | null) — 投稿日時（UTC）。
- `media_type` (string) — image または video。
- `thumbnail_url` (string) — サムネイルの URL。
- `media_url` (string | null) — メディアの URL。ファイルが保存されていない場合は null。
- `play_count` (integer | null) — 動画の再生数。
- `sponsored` (boolean) — タイアップ投稿かどうか。
- `author` (object) — account_id、username、full_name、follower_count、profile_pic_url。

## 例

```console
$ solari insight instagram ranking posts board=brand account_id=018cabce-14cc-7544-8890-7811ec33ef74 region=KR limit=2
```

_読みやすさのため、長い文字列と繰り返しの配列要素を省略しています。_

```json
{
  "account_id": "018cabce-14cc-7544-8890-7811ec33ef74",
  "kind": "all",
  "items": [
    {
      "post_id": "01a04c73-3ec3-7873-9e84-334c644abfe4",
      "slug": "DckGrZ6vZiU",
      "posted_at": "2026-08-21T10:03:52+00:00",
      "media_type": "video",
      "media_url": null,
      "thumbnail_url": "https://dcr.bzine.co/instagram/posts/DckGrZ6vZiU/thumbnails/m",
      "play_count": 155729,
      "author": {
        "account_id": "0196c474-c96e-71ad-aceb-61af051c81d3",
        "user_id": "0196c474-c96e-71ad-aceb-61af051c81d3",
        "username": "hwitto_",
        "full_name": null,
        "follower_count": 48210,
        "profile_pic_url": "https://dcr.bzine.co/instagram/users/hwitto_/profile-picture"
      },
      "sponsored": true
    },
    "… 1 more"
  ]
}
```

## MCP で呼び出す場合

```json
{
  "name": "solari_insight_instagram_ranking_posts",
  "arguments": {
    "board": "brand",
    "account_id": "018cabce-14cc-7544-8890-7811ec33ef74",
    "region": "KR",
    "limit": 2
  }
}
```

## 注意点

- 一覧と同じ region、days、（クリエイターの場合は）scope を使います。そうしないと、投稿が数値と一致しません。
- ブランドランキングの場合、投稿者の多くはそのブランドをタグ付け・メンションしたクリエイターです。
- 1 行につき、再生数の上位 6 件の投稿を保持しています。kind=organic はその中からタイアップ以外の投稿を返すため、件数が少なくなったり空になったりすることがあります。

## 関連ツール

- [`solari_insight_instagram_ranking_brands`](https://clip-pub.bzine.co/docs/tools/insight-instagram-ranking-brands.md?lang=ja)
- [`solari_insight_instagram_ranking_creators`](https://clip-pub.bzine.co/docs/tools/insight-instagram-ranking-creators.md?lang=ja)
- [`solari_catalog_instagram_content_batch`](https://clip-pub.bzine.co/docs/tools/catalog-instagram-content-batch.md?lang=ja)