Zernio
Zernio
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
Dashboard
llms.txtOpenAPI
OverviewPlatformsAPI ReferenceResources
Posting Analytics

Get YouTube channel insights

Returns channel-scoped aggregate metrics from YouTube Analytics API v2. Saves you from looping /v1/analytics/youtube/daily-views over every video when you only need channel totals.

Response shape matches /v1/analytics/instagram/account-insights so the same client handling works. Requires yt-analytics.readonly scope (412 with reauthorizeUrl if missing). Data has a 2-3 day delay (endDate is clamped accordingly). Max 89 days, defaults to last 30 days. Requires the Analytics add-on.

NOT exposed: impressions (Studio thumbnail impressions) and impressionsClickThroughRate. YouTube Analytics API v2 does not expose these for any principal type, not channel owners, not Partner Program channels, not content owners with CMS access. The only way to get them is Studio CSV export. This is a Google-side limitation.

GET
/v1/analytics/youtube/channel-insights

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

The Zernio SocialAccount ID for the YouTube account.

metrics?string

Comma-separated list. Defaults to "views,estimatedMinutesWatched,subscribersGained,subscribersLost".

Live YouTube Analytics v2 metrics:

  • views
  • estimatedMinutesWatched
  • averageViewDuration (ratio - weighted mean computed across days)
  • subscribersGained
  • subscribersLost

Zernio-synthesized from daily follower snapshots (cross-platform parity):

  • followers_gained
  • followers_lost
since?string

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

Formatdate
until?string

End date (YYYY-MM-DD). Defaults to today. YouTube Analytics has a 2-3 day delay, so the fetch is internally clamped to 3 days ago; any requested range extending beyond that returns zero values for the tail days. The response's dateRange.until field reflects your requested value.

Formatdate
metricType?string

"total_value" (default) returns aggregated totals. "time_series" returns per-day values in the "values" array.

Default"total_value"

Value in

  • "time_series"
  • "total_value"

Response Body

application/json

application/json

application/json

application/json

application/json

{  "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": "string"    },    "property2": {      "total": 0,      "values": [        {          "date": "2019-08-24",          "value": 0        }      ],      "breakdowns": [        {          "dimension": "string",          "value": 0        }      ],      "unit": "micro_amount",      "currency": "string"    }  },  "unavailableMetrics": [    {      "metric": "string",      "reason": "not_enrolled",      "message": "string"    }  ],  "dataDelay": "string"}
Was this page helpful?

Get Instagram demographics

Returns audience demographic insights for an Instagram account, broken down by age, city, country, and/or gender. Requires at least 100 followers. Returns top 45 entries per dimension. Data may be delayed up to 48 hours. Requires the Analytics add-on.

Get YouTube daily views

Returns daily view counts for a YouTube video including views, watch time, and subscriber changes. Requires yt-analytics.readonly scope (re-authorization may be needed). YouTube finalizes analytics with a ~3-day delay; by default only finalized days are returned, and an explicit endDate can reach into the delay window (see the endDate parameter). Max 90 days, defaults to last 30 days.