# solari catalog tiktok account history

> TikTok アカウントのフォロワー数・動画数の推移です。

- **CLI**: `solari catalog tiktok account history`
- **MCP ツール**: `solari_catalog_tiktok_account_history`
- **アクセス権**: `solari:read`
- **対象プラン**: 無料トライアル · Plus · Pro · Enterprise
- **クレジット**: 1

SOLARI が記録した値で、TikTok アカウントのフォロワー数、フォロー数、いいね数、動画数の推移を表示します。成長の推移をグラフにしたり、アカウント同士を比べたりするときに使います。

**どんなときに使うか** — 今の数字だけでなく、フォロワーの伸びや推移が必要なときに使います。

**返される内容** — 記録された値が古い順に並び、アカウントの現在の値も付きます。

## パラメータ

- `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。これか username を渡します。
- `username` (string, 任意, ≤ 64 chars) — TikTok のユーザー名。account_id があるときは無視されます。
- `since` (string, 任意, pattern ^\d{4}-\d{2}-\d{2}$) — 含める最初の UTC 日付 (YYYY-MM-DD)。
- `until` (string, 任意, pattern ^\d{4}-\d{2}-\d{2}$) — 含める最後の UTC 日付 (YYYY-MM-DD)。
- `granularity` (enum, 任意, 既定値 "day") — day は UTC の 1 日につき 1 点だけ残し、all はすべての点を返します。 値: `day`, `all`.

## レスポンス

### `Response`

- `found` (boolean) — カタログにないアカウントなら false です。
- `account_id / username` (string) — 特定したアカウント。
- `granularity` (string) — 適用された day または all。
- `since / until` (date) — 対象の UTC 日付範囲。
- `current` (object | null) — カタログの現在の値。日付範囲に関係なく付きます。
- `points` (object[]) — 記録された値です。古い順です。
- `truncated` (boolean) — 古い点が切り捨てられたとき true。since を狭めてください。

### `current`

- `follower_count / following_count / heart_count / video_count` (integer | null) — カタログの現在の数値。heart_count は獲得したいいねの合計です。
- `is_verified / is_private` (boolean | null) — 認証バッジと非公開かどうか。
- `collected_at` (timestamp | null) — TikTok からプロフィールを最後に収集した時刻。

### `points[]`

- `captured_at` (timestamp) — SOLARI がこの値を記録した時刻（UTC）。
- `follower_count / following_count / heart_count / video_count` (integer | null) — その時点の数値。
- `is_verified / is_private` (boolean | null) — その時点の認証バッジと非公開かどうか。

## 例

```console
$ solari catalog tiktok account history username=innisfree_official since=2026-09-20 until=2026-09-30
```

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

```json
{
  "found": true,
  "account_id": "019b2137-f76e-7b33-9437-26044fa7b1ed",
  "username": "innisfree_official",
  "granularity": "day",
  "since": "2026-09-20",
  "until": "2026-09-30",
  "current": {
    "follower_count": 144300,
    "following_count": 14,
    "heart_count": 2200000,
    "video_count": 768,
    "is_verified": true,
    "is_private": false,
    "collected_at": "2026-09-26T22:06:21.624000Z"
  },
  "points": [
    {
      "captured_at": "2026-09-20T21:23:21.898000Z",
      "follower_count": 143800,
      "following_count": 14,
      "heart_count": 2200000,
      "video_count": 767,
      "is_verified": true,
      "is_private": false
    },
    {
      "captured_at": "2026-09-24T04:16:11.995000Z",
      "follower_count": 143800,
      "following_count": 14,
      "heart_count": 2200000,
      "video_count": 768,
      "is_verified": true,
      "is_private": false
    },
    {
      "captured_at": "2026-09-26T22:06:21.624000Z",
      "follower_count": 144300,
      "following_count": 14,
      "heart_count": 2200000,
      "video_count": 768,
      "is_verified": true,
      "is_private": false
    }
  ],
  "truncated": false
}
```

## MCP で呼び出す場合

```json
{
  "name": "solari_catalog_tiktok_account_history",
  "arguments": {
    "username": "innisfree_official",
    "since": "2026-09-20",
    "until": "2026-09-30"
  }
}
```

## 注意点

- since と until は UTC 日付で、両端を含みます。指定しなければ直近 90 日です。
- SOLARI がアカウントを収集したときにだけ値が残るため、途中に空白があるのは正常です。
- 2025-12-15 より前の記録はありません。
- TikTok は 10,000 以上の数値を丸めて返します。そのため、小さな変化は表れません。
- current を今日の数字として扱う前に、current.collected_at を確認してください。
- カタログだけを読みます。アカウントがない場合は、先に solari fetch tiktok account username=… を呼んでください。記録はそこから始まり、過去の値は埋められません。

## 関連ツール

- [`solari_catalog_tiktok_account_profile`](https://solari.sh/docs/tools/catalog-tiktok-account-profile.md?lang=ja)
- [`solari_catalog_tiktok_account_posts`](https://solari.sh/docs/tools/catalog-tiktok-account-posts.md?lang=ja)
- [`solari_fetch_tiktok_account`](https://solari.sh/docs/tools/fetch-tiktok-account.md?lang=ja)
- [`solari_catalog_instagram_account_history`](https://solari.sh/docs/tools/catalog-instagram-account-history.md?lang=ja)