← 전체 도구
tiktok · catalog · accountsolari:read

solari catalog tiktok account history

TikTok 계정의 팔로워·영상 수 추이예요.

MCP 도구
solari_catalog_tiktok_account_history
CLI
solari catalog tiktok account history
권한
solari:read
이용 가능 플랜
  • 무료 체험
  • Plus
  • Pro
  • Enterprise
크레딧
1

개요

SOLARI가 기록해 둔 값으로 TikTok 계정의 팔로워, 팔로잉, 좋아요, 영상 수가 시간에 따라 어떻게 변했는지 보여 줘요. 성장 추이를 그리거나 계정끼리 비교할 때 써요.

언제 쓰나요 — 지금 숫자만이 아니라 팔로워 성장이나 추이가 필요할 때 사용해요.

돌려주는 값 — 기록된 값이 오래된 순으로 오고, 계정의 현재 값도 같이 와요.

파라미터

account_idstring선택
account_id 또는 username을 넣어요.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)$
usernamestring선택
TikTok 사용자명. account_id가 있으면 무시돼요≤ 64 chars
sincestring선택
포함할 첫 UTC 날짜 (YYYY-MM-DD)pattern ^\d{4}-\d{2}-\d{2}$
untilstring선택
포함할 마지막 UTC 날짜 (YYYY-MM-DD)pattern ^\d{4}-\d{2}-\d{2}$
granularityenum선택
day는 UTC 하루에 한 점만 남기고, all은 모든 점을 돌려줘요기본값 "day"값dayall

응답

Response

foundboolean
카탈로그에 없는 계정이면 false예요.
account_id / usernamestring
찾은 계정이에요
granularitystring
적용된 day 또는 all이에요
since / untildate
조회한 UTC 날짜 범위예요
currentobject | null
카탈로그의 현재 값이에요. 날짜 범위와 상관없이 와요
pointsobject[]
기록된 값이에요. 오래된 순이에요
truncatedboolean
오래된 점이 잘렸으면 true예요. since를 좁혀서 다시 보세요

current

follower_count / following_count / heart_count / video_countinteger | null
카탈로그의 현재 수치예요. heart_count는 받은 좋아요 합계예요
is_verified / is_privateboolean | null
인증 배지와 비공개 여부예요
collected_attimestamp | null
TikTok에서 프로필을 마지막으로 수집한 시각이에요

points[]

captured_attimestamp
SOLARI가 이 값을 기록한 시각 (UTC)
follower_count / following_count / heart_count / video_countinteger | null
그 시점의 수치예요
is_verified / is_privateboolean | null
그 시점의 인증 배지와 비공개 여부예요

예시

요청

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

응답 · 읽기 편하도록 긴 문자열과 반복되는 배열 항목을 줄였습니다.

{
  "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 호출

{
  "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=… 를 호출해 주세요. 기록은 그때부터 쌓이고, 지난 값은 채울 수 없어요.

에이전트용 문서: /docs/tools/catalog-tiktok-account-history.md