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.
API key authentication - use your Zernio API key as a Bearer token
In: header
Query Parameters
The Zernio SocialAccount ID for the connected Facebook Page.
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)
- page_views_total
- page_post_engagements
- page_video_views
- page_video_view_time
- page_follows (replaces deprecated page_fans)
Zernio-synthesized from daily follower snapshots (filling the Nov-2025 gap left by the page_fan_adds / page_fan_removes deprecation):
- followers_gained
- followers_lost
Start date (YYYY-MM-DD). Defaults to 30 days ago.
dateEnd date (YYYY-MM-DD). Defaults to today.
date"total_value" (default) returns aggregated totals only. "time_series" returns daily values in the "values" array.
"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.getFacebookPageInsights({ query: { accountId: 'account_abc123', },});console.log(data);{
"success": true,
"accountId": "64e1a2b3c4d5e6f7a8b9c0d1",
"platform": "facebook",
"dateRange": {
"since": "2026-03-01",
"until": "2026-03-22"
},
"metricType": "time_series",
"metrics": {
"page_media_view": {
"total": 125000,
"values": [
{
"date": "2026-03-01",
"value": 5400
},
{
"date": "2026-03-02",
"value": 4820
}
]
},
"followers_gained": {
"total": 142,
"values": [
{
"date": "2026-03-01",
"value": 7
},
{
"date": "2026-03-02",
"value": 5
}
]
},
"followers_lost": {
"total": 23,
"values": [
{
"date": "2026-03-01",
"value": 1
},
{
"date": "2026-03-02",
"value": 0
}
]
}
},
"dataDelay": "Meta page insights may be delayed up to 24 hours. Metrics reflect the current (post-November 2025) Graph API names."
}{
"error": "Unauthorized"
}Get daily aggregated metrics GET
Returns daily aggregated analytics metrics and a per-platform breakdown. Each day includes post count, platform distribution, and summed metrics (impressions, reach, likes, comments, shares, saves, clicks, views). Defaults to the last 180 days. Requires the Analytics add-on.
Get follower stats GET
Returns follower count history and growth metrics for connected social accounts. Requires analytics add-on subscription. Follower counts are refreshed once per day.