# solari insight instagram ranking find

> ブランドとクリエイターのランキングで、1 つのアカウントの順位を調べます。

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

ブランドかクリエイターかわからない Instagram のアカウントの位置を調べます。掲載されているランキングごとに、所属するすべてのカテゴリでの順位と上位何 % かを返します。

**どんなときに使うか** — 「このアカウントは何位か」「タイアップ以外のコンテンツの成果はどうか」を知りたいが、どちらのランキングかわからないとき。

**返される内容** — ブランド側とクリエイター側の結果。アカウントがそのランキングにない場合、その側は null になります。

## パラメータ

- `username` (string, 必須, ≤ 64 chars) — Instagram の username（@ の有無は問いません）。
- `region` (enum, 任意, 既定値 "KR") — KR、JP、US のいずれか。クリエイターランキングは KR と JP のみが対象です。 値: `KR`, `JP`, `US`.
- `days` (integer, 任意, 既定値 30) — 30 または 90。

## レスポンス

### `Response`

- `username` (string) — 調べたハンドル。
- `region / days` (string · integer) — 適用された設定。
- `sort` (string) — 常に plays（総再生数）。
- `brand` (object | null) — ブランドランキングでの位置。
- `creator` (object | null) — クリエイターランキングでの位置。

### `brand · creator`

- `account` (object) — account_id、username、full_name、follower_count。
- `row` (object | null) — 全体での行データ。フィールドは対応するランキングツールと同じで、オーガニックの内訳（organic_post_count、organic_total_plays、organic_median_plays、sponsored_share）も含みます。
- `positions` (object[]) — 順位が付いているカテゴリごとに 1 件。
- `positions[].scope / rank / total / top_pct` (string · integer · number) — カテゴリ、順位、順位付けされた数、上位何 %（最小 0.1）。
- `positions[].share` (number | null) — クリエイター側のみ。投稿全体に占めるそのカテゴリの割合。
- `min_posts / min_followers` (integer) — アカウントが除外されないように使った、最も緩い絞り込み条件。
- `list_kind` (string) — クリエイター側のみ。creator または magazine。
- `snapshot_at` (timestamp | null) — ランキングを作成した日時。

## 例

```console
$ solari insight instagram ranking find username=innisfreeofficial region=KR
```

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

```json
{
  "username": "innisfreeofficial",
  "region": "KR",
  "days": 30,
  "sort": "plays",
  "brand": {
    "account": {
      "account_id": "018cabce-14cc-7544-8890-7811ec33ef74",
      "user_id": "018cabce-14cc-7544-8890-7811ec33ef74",
      "username": "innisfreeofficial",
      "full_name": "INNISFREE | 이니스프리",
      "follower_count": 847619
    },
    "min_posts": 1,
    "row": {
      "account_id": "018cabce-14cc-7544-8890-7811ec33ef74",
      "rank": 7,
      "user_id": "018cabce-14cc-7544-8890-7811ec33ef74",
      "username": "innisfreeofficial",
      "post_count": 1204,
      "total_plays": 38920400,
      "median_plays": 14120,
      "sponsored_post_count": 402,
      "sponsored_total_plays": 17610200,
      "organic_median_plays": 11900,
      "categories": [
        "BEAUTY/SKINCARE"
      ],
      "organic_post_count": 802,
      "organic_total_plays": 21310200,
      "sponsored_share": 0.3339
    },
    "positions": [
      {
        "scope": "all",
        "rank": 7,
        "total": 21483,
        "top_pct": 0.1
      },
      {
        "scope": "d1:BEAUTY",
        "rank": 4,
        "total": 3120,
        "top_pct": 0.1
      },
      {
        "scope": "d2:BEAUTY/SKINCARE",
        "rank": 2,
        "total": 1843,
        "top_pct": 0.1
      }
    ],
    "snapshot_at": "2026-09-22T19:04:11.482913+00:00"
  },
  "creator": null
}
```

## MCP で呼び出す場合

```json
{
  "name": "solari_insight_instagram_ranking_find",
  "arguments": {
    "username": "innisfreeofficial",
    "region": "KR"
  }
}
```

## 注意点

- 最も緩い絞り込み条件を使うため、条件の厳しい一覧より順位が高く出ることがあります。

## 関連ツール

- [`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)