TikTok Profile & Video Stats

Follower, like, view and engagement counts for any TikTok profile or video in one request each — no browser, no login. Pass handles or URLs, get JSON in seconds.

What it does

Give it TikTok handles, profile URLs, video URLs, 19-digit video ids or vm.tiktok.com short links — mixed, as many as you like — and it returns one JSON record per entry: a profile record (followers, following, total likes, video count, friends, bio, verified, private, region, account creation date, avatar) or a video record (plays, likes, comments, shares, saves, reposts, engagement rate, caption, hashtags, mentions, music, duration, cover image, posting time, plus the author's handle and follower/like/video counts). Every record is exactly one plain HTTP request to the public page, so a lookup answers in about a second and a 240-entry batch finishes in just over a minute at ~190 records/minute (measured 2026-10-30 from a datacenter IP, 0 blocked pages). Built for agents and pipelines: three inputs, strong defaults, the first record streams in ~1.3 s, pay per record.

Input

Field	Type	Default	Description
queries	string[]	["tiktok"]	Handles (khaby.lame, @khaby.lame), profile URLs, video URLs, 19-digit video ids or short links (vm.tiktok.com/…, tiktok.com/t/…). Duplicates are collapsed before any request is made.
maxItems	integer	100	Total records to return (1–5000). One record = one request, so this caps the cost too.
proxyConfiguration	object	Apify Proxy (datacenter)	Datacenter proxies work for these pages. Switch to a RESIDENTIAL group only if SUMMARY.blocked or SUMMARY.shellPages is non-zero.

Entries that are not a TikTok handle or URL are skipped and listed in SUMMARY.invalidQueries. Profiles or videos that TikTok reports as missing, private, banned or region-locked cost nothing: no record is written, and the reason is listed per query in SUMMARY.unavailableQueries (user does not exist, private account, video not found, …).

Output

Profile record

{
  "kind": "profile",
  "id": "khaby.lame",
  "userId": "127905465618821121",
  "secUid": "MS4wLjABAAAAwAg0rSzO65WQfz4RzQgGv2Xdv108BgPXhRrrmNVIHQZ9PO8-flwwRtEppYTS0OjA",
  "url": "https://www.tiktok.com/@khaby.lame",
  "handle": "khaby.lame",
  "title": "Khabane lame",
  "description": "Se vuoi ridere sei nel posto giusto😎 If u wanna laugh u r in the right place😎",
  "verified": true,
  "privateAccount": false,
  "region": null,
  "language": "en",
  "createdAt": "2016-08-10T22:02:34.000Z",
  "followers": 162963015,
  "following": 82,
  "likes": 2691460214,
  "videos": 1359,
  "friends": 77,
  "bioLink": null,
  "images": ["https://p16-common-sign.tiktokcdn-us.com/…jpeg"],
  "commerceUser": false,
  "ttSeller": false,
  "source": { "query": "khaby.lame" },
  "scrapedAt": "2026-10-30T23:04:48.149Z"
}

Video record

{
  "kind": "video",
  "id": "6768504823336815877",
  "url": "https://www.tiktok.com/@zachking/video/6768504823336815877",
  "title": "They rejected my application to Hogwarts but I still found a way to be a wizard. 🧹#illusion #magic #harrypotter",
  "description": "They rejected my application to Hogwarts but I still found a way to be a wizard. 🧹#illusion #magic #harrypotter",
  "postedAt": "2019-12-09T18:15:37.000Z",
  "author": { "handle": "zachking", "userId": "68616495085350913", "nickname": "Zach King", "verified": true, "followers": 86800000, "likes": 1300000000, "videos": 620 },
  "plays": 2400000000,
  "likes": 29600000,
  "comments": 788500,
  "shares": 1100000,
  "saves": 999259,
  "reposts": 0,
  "engagementRate": 0.0135,
  "durationSeconds": 18,
  "hashtags": ["illusion", "magic", "harrypotter", "수리수리마수리", "影視特效"],
  "mentions": [],
  "music": { "id": "6768109565536946950", "title": "Zach Kings Magic Broomstick", "author": "Zach King", "original": true },
  "images": ["https://p16-common-sign.tiktokcdn-us.com/…image"],
  "width": 576,
  "height": 1090,
  "isAd": false,
  "isAigc": false,
  "locationCreated": "US",
  "textLanguage": "en",
  "duetEnabled": true,
  "stitchEnabled": true,
  "commentsEnabled": true,
  "source": { "query": "https://www.tiktok.com/@zachking/video/6768504823336815877" },
  "scrapedAt": "2026-10-30T23:05:08.259Z"
}

engagementRate = (likes + comments + shares + saves) / plays, rounded to 4 decimals. Counts come from TikTok's exact statsV2 values, so videos past 2.1 billion plays are reported correctly (the rounded stats block overflows there). Field names follow the convention shared by all mdcurt Actors: id, url, title, postedAt (ISO 8601), images[], description (≤300 chars), kind, source, scrapedAt.

The key-value store holds a SUMMARY record: profile/video counts, unavailableQueries with reasons, invalidQueries, blocked and shell pages, p95 latency, time to first record and compute seconds.

Pricing

Pay per event: $0.005 per run start plus $0.0015 per record. A single profile or video lookup costs $0.0065; 1,000 lookups cost $1.51. That is half the $0.003 per-result median of the TikTok Actors on the Store, because each record is one lightweight HTTP request on 256 MB of memory — there is no browser to pay for. Missing, private or deleted targets are not charged.

Monitoring creators and videos cheaply

Schedule the Actor with your list of handles and video URLs (a daily run of 100 handles costs about $0.16) and pair it with mdcurt/dataset-diff-monitor with keyFields: ["id"] and watchFields: ["followers","likes","plays"] to get a Slack, Discord, Telegram or webhook message only when a count changes.

Speed

From the live tests on 2026-10-30 (datacenter proxy): first record in 1.2–1.6 s; a 242-entry batch returned 226 records in 70 s (~193 records/minute, concurrency ramped automatically from 2 to 6, p95 latency 1.4 s, 0 blocked, 0 failed). The crawler backs off on the first 429 and halves concurrency if the error rate rises above 2 %.

Limitations

• Lookups only: it does not list a profile's videos, search, hashtags, comments or followers — those need TikTok's signed internal API, which this Actor deliberately does not call. For a creator's latest videos use a dedicated TikTok scraper and feed the video URLs here for fresh counts.
• Output is metadata only: no video or audio files, no full comment threads; images carries the public cover/avatar URL (signed, expires after a few hours).
• E-mail addresses or phone numbers in bios are redacted and an e-mail used as the bio link is dropped (public creator statistics are returned, contact data is not harvested).
• Private accounts return their stats only if TikTok shows them publicly; otherwise they are reported under SUMMARY.unavailableQueries as private account.
• Short links are resolved by following TikTok's redirect; a short link that lands on the homepage (expired or invalid) is reported as short link did not resolve.

Changelog

• 1.0.0 (2026-10-30) — first release: profile and video lookups, short-link resolution, exact statsV2 counts, engagement rate, free not-found handling.