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/.
API key authentication - use your Zernio API key as a Bearer token
In: header
Query Parameters
The Zernio SocialAccount ID for the TikTok account.
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)
Start date (YYYY-MM-DD). Defaults to 30 days ago.
dateEnd date (YYYY-MM-DD). Defaults to today.
date"total_value" returns the latest cumulative counter value. "time_series" returns daily values joined from AccountStats snapshots.
"total_value""time_series" | "total_value"Response Body
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.analytics.getTikTokAccountInsights({ query: { accountId: 'account_abc123', },});console.log(data);{
"success": true,
"accountId": "string",
"platform": "facebook",
"dateRange": {
"since": "2019-08-24",
"until": "2019-08-24"
},
"metricType": "time_series",
"breakdown": "string",
"metrics": {
"property1": {
"total": 0,
"values": [
{
"date": "2019-08-24",
"value": 0
}
],
"breakdowns": [
{
"dimension": "string",
"value": 0
}
],
"unit": "micro_amount",
"currency": "USD"
},
"property2": {
"total": 0,
"values": [
{
"date": "2019-08-24",
"value": 0
}
],
"breakdowns": [
{
"dimension": "string",
"value": 0
}
],
"unit": "micro_amount",
"currency": "USD"
}
},
"unavailableMetrics": [
{
"metric": "string",
"reason": "not_enrolled",
"message": "string"
}
],
"dataDelay": "Data may be delayed up to 48 hours"
}{
"error": "Unauthorized"
}Get Facebook post monetization earnings GET
Returns lifetime monetization earnings for ONE Facebook post, read live from Meta on every request. Requires the Analytics add-on. Earnings are CUMULATIVE since the post was published, not earnings within a date range, so this endpoint takes no since/until and the totals must not be summed across dates or across posts. Page-level daily earnings live on /v1/analytics/facebook/page-insights. A post on a Page that is not enrolled in monetization, or that earned nothing, returns "total": 0 rather than an error: Meta does not distinguish the two. A metric Meta returned no bucket for at all is reported in "unavailableMetrics" and omitted from "metrics", never as a 0. Amounts are the platform's raw numbers in the stated "unit" and are never rescaled by Zernio. Breakdown dimensions are not exposed and a "breakdown" param is rejected with 400. So are "since", "until", "period", and "metricType": scoping this endpoint to a window is not possible, and silently returning the lifetime total for one would let a caller sum a year of weekly requests into a figure ~52x the post's real earnings.
Get GBP performance metrics GET
Returns daily performance metrics for a Google Business Profile location. Metrics include impressions (Maps/Search, desktop/mobile), website clicks, call clicks, direction requests, conversations, bookings, and food orders. Data may be delayed 2-3 days. Max 18 months of historical data. Requires the Analytics add-on.