Zernio API Docs

Appearance

Get Facebook Page insights ​

Returns page-level Facebook insights (media views, views, post engagements, video metrics, follower counts). Response shape matches /v1/analytics/instagram/account-insights so the same client handling works across platforms.

Metric names track the current (post-November 2025) Meta Graph API. The legacy page_impressions / page_fans / page_fan_adds / page_fan_removes metrics were deprecated by Meta on November 15, 2025 and are NOT accepted by this endpoint. Use the replacements below. Because Meta did not provide direct adds/removes replacements, Zernio synthesizes followers_gained / followers_lost from the daily follower snapshotter.

Max 89 days, defaults to last 30 days. Requires the Analytics add-on.

GET /v1/analytics/facebook/page-insights ​

Returns page-level Facebook insights (media views, views, post engagements, video metrics, follower counts). Response shape matches /v1/analytics/instagram/account-insights so the same client handling works across platforms.

Metric names track the current (post-November 2025) Meta Graph API. The legacy page_impressions / page_fans / page_fan_adds / page_fan_removes metrics were deprecated by Meta on November 15, 2025 and are NOT accepted by this endpoint. Use the replacements below. Because Meta did not provide direct adds/removes replacements, Zernio synthesizes followers_gained / followers_lost from the daily follower snapshotter.

Max 89 days, defaults to last 30 days. Requires the Analytics add-on.

Parameters ​

  • accountId (query, string) required — The Zernio SocialAccount ID for the connected Facebook Page.

  • metrics (query, string) — Comma-separated list of metrics. Defaults to "page_media_view,page_post_engagements,page_follows,followers_gained,followers_lost". Live Meta metrics (current names, post-Nov-2025): - page_media_view (replaces deprecated page_impressions) -...

  • since (query, string) — Start date (YYYY-MM-DD). Defaults to 30 days ago.

  • until (query, string) — End date (YYYY-MM-DD). Defaults to today.

  • metricType (query, string) — "total_value" (default) returns aggregated totals only. "time_series" returns daily values in the "values" array.

Responses ​

200 — Page insights data

  • success (boolean)
  • accountId (string) — The Zernio SocialAccount ID
  • platform (string) (enum: facebook, instagram, youtube, linkedin, tiktok) — Platform that served this response.
  • dateRange (object)
  • metricType (string) (enum: time_series, total_value)
  • breakdown (string) — Breakdown dimension used (only present when breakdown was requested)
  • metrics (object) — 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" (arr...
  • dataDelay (string)

400 — Bad request. Common cases:

  • Requested a deprecated metric (page_impressions, page_fans, page_fan_adds, page_fan_removes) - use current names instead
  • Account has no Page selected (metadata.pageAccessToken missing)
  • Invalid accountId / metrics / metricType / date range
  • Account is not a Facebook account

401

402 — Analytics access required. Legacy plans need the Analytics add-on; included by default on usage-based plans.

404 — Account not found