Sign in
Analytics

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: this ACCOUNT-level endpoint exposes only the four counter metrics below. These account-level figures are not on any public TikTok API, for any account type:

  • account-level impressions / reach
  • follower inflow / outflow breakdown
  • account-level watch time and audience demographics

TikTok's Research API doesn't expose them either, and is restricted to non-commercial academic use per TikTok's eligibility policy.

PER-VIDEO is a different story on the Business lane. An account connected through the TikTok for Business app reports profile views, website clicks, follows, full-watched rate, watch time, impression sources, viewer types and viewer countries per video on GET /v1/analytics?postId=..., roughly 24-48h after publishing and only for posts active in the last 7 days. Accounts on the original TikTok integration get the basic counters there (views, likes, comments, shares) and zeros for the rest; they must reconnect through the Business app.

get/v1/analytics/tiktok/account-insights

Query parameters

accountIdstring required

The Zernio SocialAccount ID for the TikTok account.

metricsstring

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)
  • following_count (cumulative; time series joined from AccountStats.metadata)
  • likes_count (cumulative; time series joined from AccountStats.metadata)
  • video_count (cumulative; time series joined from AccountStats.metadata)

Zernio-synthesized:

  • followers_gained (sum of positive daily follower deltas)
  • followers_lost (sum of absolute negative daily deltas)
fromDatestring date

Start date (YYYY-MM-DD). Defaults to 30 days ago.

toDatestring date

End date (YYYY-MM-DD). Defaults to today.

sincestring date

Alias of fromDate, kept for existing callers

untilstring date

Alias of toDate, kept for existing callers

metricType'time_series' | 'total_value'

"total_value" returns the latest cumulative counter value. "time_series" returns daily values joined from AccountStats snapshots.

Response

Account insights data

successboolean
accountIdstring

The Zernio SocialAccount ID

platform'facebook' | 'instagram' | 'youtube' | 'linkedin' | 'tiktok'

Platform that served this response.

metricType'time_series' | 'total_value'
breakdownstring

Breakdown dimension used (only present when breakdown was requested)

metricsobject

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" (array of {dimension, value}).

Monetary metrics additionally carry "unit" and "currency". Zernio never rescales money: "total" and every "values[].value" are the platform's raw numbers in the stated unit. Monetary metrics also keep "values" on metricType=total_value, because their "total" is the sum of the daily buckets the platform returned over the range: keep the series so you can reconcile that sum against the platform's own reporting before invoicing on it. A metric that could not be served is absent from this object and listed in "unavailableMetrics" instead, so an unavailable metric is never reported as a zero.

dataDelaystring

Example response

{
  "success": true,
  "dataDelay": "Data may be delayed up to 48 hours"
}

Changes

Changed in 1 of the 56 revisions of this API.4

  • dd3865482f9f4See the full diff
    • ○

      added the new optional query request parameter fromDate

      new-optional-request-parameter

    • ○

      added the new optional query request parameter toDate

      new-optional-request-parameter

    • ○

      query request parameter since was deprecated

      request-parameter-deprecated

    • ○

      query request parameter until was deprecated

      request-parameter-deprecated