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

Get post samples

Returns the raw readings behind a post's numbers, oldest first. Each sample is one analytics sync: the views and engagement as the platform reported them at syncedAt. Zernio only stores what it fetched from the platform, so nothing here was self-reported. shares and saves are null on platforms that do not return that counter, which is different from a real zero. watchSeconds and completionRate are null when the platform gives no watch signal. Requires the Analytics add-on.

PlatformsTikTokLinkedInPinterest
GET
/v1/analytics/samples

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Query Parameters

postId*string

The post to read samples for. Accepts an external post id, a platform post id or a Zernio post id.

fromDate?string

Earliest sample to return (ISO 8601).

Formatdate-time
toDate?string

Latest sample to return (ISO 8601).

Formatdate-time
limit?integer

Maximum number of samples.

Range1 <= value <= 2000
Default500

Response Body

application/json

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.getPostSamples({  query: {    postId: 'post_abc123',  },});console.log(data);
{  "postId": "string",  "samples": [    {      "syncedAt": "2019-08-24T14:15:22Z",      "views": 0,      "likes": 0,      "comments": 0,      "shares": 0,      "saves": 0,      "watchSeconds": 0,      "completionRate": 0    }  ]}
Was this page helpful?

Get a post's authenticity score

Returns Zernio's authenticity score for a post: an integer from 0 to 100 where higher means the view pattern looks more like organic viewing. The score is ours. It is computed only from the verified samples we fetched from the platform, never from anything the creator or caller reported, and `reasons` lists each factor that lowered it with its weight in points. `confidence` (0 to 1) says how much data the score rests on. A stored score newer than 30 minutes is returned as is, otherwise it is recomputed. The `post.authenticity_changed` webhook fires when a score crosses 40. Requires the Analytics add-on.

Get a tracking window

Returns one tracking window with the latest verified numbers we read from the platform. Once the window has completed, `finalReadAt` and `completionReason` say how it closed. Requires the Analytics add-on.