Appearance
Get TikTok account-level insights
Returns account-level TikTok insights from /v2/user/info/ (live) plus historical time series joined from Zernio's daily snapshotter (AccountStats).
Response shape matches /v1/analytics/instagram/account-insights. Max 89 days, defaults to last 30 days. Requires the Analytics add-on and the user.info.stats scope on the account (412 if missing).
Scope intentionally narrow. TikTok's public API exposes only the four counter metrics below. The deep metrics that live in TikTok Studio are NOT available on any public TikTok API, even for Business accounts:
- profile_views
- account-level impressions / reach
- follower inflow / outflow breakdown
- video watch time, average watch time, full-watched rate
- impression_sources (FYP / Following / Hashtag / Search / Personal profile)
TikTok's Research API doesn't expose those fields either, and is restricted to non-commercial academic use per TikTok's eligibility policy. There is no public API workaround. Post-level metrics (views, likes, comments, shares per video) are available via /v1/analytics?postId=... from TikTok's /v2/video/query/.
GET /v1/analytics/tiktok/account-insights
Returns account-level TikTok insights from /v2/user/info/ (live) plus historical time series joined from Zernio's daily snapshotter (AccountStats).
Response shape matches /v1/analytics/instagram/account-insights. Max 89 days, defaults to last 30 days. Requires the Analytics add-on and the user.info.stats scope on the account (412 if missing).
Scope intentionally narrow. TikTok's public API exposes only the four counter metrics below. The deep metrics that live in TikTok Studio are NOT available on any public TikTok API, even for Business accounts:
- profile_views
- account-level impressions / reach
- follower inflow / outflow breakdown
- video watch time, average watch time, full-watched rate
- impression_sources (FYP / Following / Hashtag / Search / Personal profile)
TikTok's Research API doesn't expose those fields either, and is restricted to non-commercial academic use per TikTok's eligibility policy. There is no public API workaround. Post-level metrics (views, likes, comments, shares per video) are available via /v1/analytics?postId=... from TikTok's /v2/video/query/.
Parameters
accountId(query, string) required — The Zernio SocialAccount ID for the TikTok account.metrics(query, string) — Comma-separated list. Defaults to "follower_count,likes_count,video_count,followers_gained,followers_lost". Live from /v2/user/info/ (requires user.info.stats scope): - follower_count (cumulative; time series joined from AccountStats) - followi...since(query, string) — Start date (YYYY-MM-DD). Defaults to 30 days ago.until(query, string) — End date (YYYY-MM-DD). Defaults to today.metricType(query, string) — "total_value" returns the latest cumulative counter value. "time_series" returns daily values joined from AccountStats snapshots.
Responses
200 — Account insights data
success(boolean)accountId(string) — The Zernio SocialAccount IDplatform(string) (enum: facebook, instagram, youtube, linkedin, tiktok) — Platform that served this response.dateRange(object)metricType(string) (enum: time_series, total_value)breakdown(string) — Breakdown dimension used (only present when breakdown was requested)metrics(object) — Object keyed by metric name. For time_series: each metric has "total" (number) and "values" (array of {date, value}). For total_value: each metric has "total" (number) and optionally "breakdowns" (arr...dataDelay(string)
400 — Bad request (invalid accountId / metrics / metricType / date range, or account is not a TikTok account)
401
402 — Analytics access required. Legacy plans need the Analytics add-on; included by default on usage-based plans.
404 — Account not found
412 — Missing user.info.stats scope