Zernio
APIFor you
Zernio
APIFor you
API Reference

Posting Analytics

Cross-platform

Get post analyticsGETAnalytics changed since a cursorGETSync an external postPOSTGet post analytics timelineGETGet daily aggregated metricsGETGet best times to postGETGet content performance decayGETGet frequency vs engagementGETGet follower statsGET

Instagram

Get Instagram insightsGETGet Instagram follower historyGETGet Instagram demographicsGET

YouTube

Get YouTube channel insightsGETGet YouTube daily viewsGETGet YouTube video retention curveGETGet YouTube demographicsGET

LinkedIn

Get LinkedIn aggregate statsGETGet LinkedIn org analyticsGETGet LinkedIn post statsGETGet LinkedIn post reactionsGET

Facebook

Get Facebook Page insightsGETGet Facebook post reactionsGETGet Facebook post monetization earningsGET

TikTok

Get TikTok account-level insightsGET

Google Business

Get Google Business Profile performance metricsGETGet Google Business Profile search keywordsGET

Other

Cancel a tracking windowDELETEGet an analytics dashboardGETGet Facebook Page demographicsGETList Google Analytics (GA4) dimensions and metricsGETGet Instagram online followersGETGet LinkedIn organization follower demographicsGETGet a post's authenticity scoreGETGet post samplesGETGet a tracking windowGETList the posts a Facebook Page is tagged inGETList visitor posts on a Facebook PageGETList authenticity scoresGETList tracking windowsGETOpen a tracking windowPOSTRun a Google Analytics (GA4) realtime reportPOSTRun a Google Analytics (GA4) reportPOST
Dashboard
OverviewPlatformsAPI ReferenceResources
Posting Analytics

List tracking windows

Lists the tracking windows you can see, newest first. Each window carries the latest verified numbers we read from the platform. Requires the Analytics add-on.

PlatformsTikTokLinkedInPinterest
GET
/v1/analytics/tracking

Authorization

bearerAuth
AuthorizationBearer <token>

API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.

In: header

Query Parameters

accountId?string

Only windows for this connected account.

status?string

Only windows in this status.

Value in

  • "open"
  • "completing"
  • "completed"
  • "cancelled"
limit?integer

Page size.

Range1 <= value <= 200
Default50
skip?integer

Number of windows to skip.

Range0 <= value
Default0

Response Body

application/json

application/json

application/json

application/json

application/json

import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.analytics.listTrackingWindows();console.log(data);
{  "windows": [    {      "id": "string",      "postId": "string",      "accountId": "string",      "platform": "string",      "platformPostId": "string",      "startsAt": "2019-08-24T14:15:22Z",      "endsAt": "2019-08-24T14:15:22Z",      "status": "open",      "finalReadAt": "2019-08-24T14:15:22Z",      "completionReason": "final_read",      "requestedBy": "string",      "latest": {        "views": 0,        "likes": 0,        "comments": 0,        "shares": 0,        "saves": 0,        "syncedAt": "2019-08-24T14:15:22Z"      }    }  ]}
Was this page helpful?

List authenticity scores

Lists the stored authenticity scores for one connected account, newest first. Scores are 0 to 100 and come from Zernio's own model over verified platform samples. Filter with `minScore` and `maxScore` to find posts that look inflated, and with `from` and `to` to bound when the score was computed. Requires the Analytics add-on.

Open a tracking window

Starts watching a post's views and engagement. Zernio fetches the numbers from the platform itself on its regular analytics sync, so every reading is verified: it is a value we read from the platform, never one the creator or the caller reported. The window runs for `trackingDays` (30 by default, 90 at most) and ends with one final read, after which the `post.tracking_completed` webhook fires. Identify the post with `postId` (an external post id from Zernio), or with `accountId` together with the post's `url`. Opening a window for a post that is already tracked returns the existing window with `200`. A new window returns `201`. Requires the Analytics add-on.