# 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 하루에 한 점만 남기고, 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://finder-dev-pub.bzine.co/docs/tools/catalog-tiktok-account-profile.md?lang=ko)
- [`solari_catalog_tiktok_account_posts`](https://finder-dev-pub.bzine.co/docs/tools/catalog-tiktok-account-posts.md?lang=ko)
- [`solari_fetch_tiktok_account`](https://finder-dev-pub.bzine.co/docs/tools/fetch-tiktok-account.md?lang=ko)
- [`solari_catalog_instagram_account_history`](https://finder-dev-pub.bzine.co/docs/tools/catalog-instagram-account-history.md?lang=ko)