for agents
← All tools
tiktok · catalog · accountsolari:read

solari catalog tiktok account history

A TikTok account's follower and video counts over time.

MCP tool
solari_catalog_tiktok_account_history
CLI
solari catalog tiktok account history
Access
solari:read
Plans
  • Free Trial
  • Plus
  • Pro
  • Enterprise
Credit
1

Overview

Follower, following, like, and video counts of a TikTok account over time, as SOLARI recorded them. Use it to chart growth or compare accounts.

When to use it — When you need follower growth or a trend, not just today's numbers.

What comes back — Recorded values, oldest first, plus the account's current values.

Parameters

account_idstringoptional
Pass account_id or 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)$
usernamestringoptional
TikTok username. Ignored when account_id is set.≤ 64 chars
sincestringoptional
First UTC date to include (YYYY-MM-DD).pattern ^\d{4}-\d{2}-\d{2}$
untilstringoptional
Last UTC date to include (YYYY-MM-DD).pattern ^\d{4}-\d{2}-\d{2}$
granularityenumoptional
day keeps one point per UTC day. all keeps every point.default "day"Valuesdayall

Response

Response

foundboolean
false if the account is not in the catalog.
account_id / usernamestring
The resolved account.
granularitystring
day or all, as applied.
since / untildate
The UTC date range covered.
currentobject | null
The catalog's current values, whatever the date range.
pointsobject[]
Recorded values, oldest first.
truncatedboolean
true if older points were dropped. Narrow since to see them.

current

follower_count / following_count / heart_count / video_countinteger | null
Current counts in the catalog. heart_count is total likes received.
is_verified / is_privateboolean | null
Verification badge and private flag.
collected_attimestamp | null
When the profile was last collected from TikTok.

points[]

captured_attimestamp
When SOLARI recorded these values (UTC).
follower_count / following_count / heart_count / video_countinteger | null
Counts at that moment.
is_verified / is_privateboolean | null
Verification badge and private flag at that moment.

Example

Request

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

Response · Long strings and repeated array entries are trimmed for readability.

{
  "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
}

As an MCP call

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

Notes

  • since and until are UTC dates, and both ends are included. Without them you get the last 90 days.
  • A point exists only when SOLARI collected the account, so gaps between points are normal.
  • No points exist before 2025-12-15.
  • TikTok rounds counts of 10,000 and above, so small changes between points do not show.
  • Check current.collected_at before treating current as today's numbers.
  • This reads the catalog only. If the account is missing, call solari fetch tiktok account username=… first. Recording starts from then; past values cannot be filled in.

Related tools

Machine-readable: /docs/tools/catalog-tiktok-account-history.md