Get Facebook Page insights

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

Monetization (opt-in, not in the defaults):

• content_monetization_earnings: an object per day, always with unit "micro_amount" and an ISO 4217 "currency".
• monetization_approximate_earnings: a bare number per day; unit is always "unspecified" and "currency" always null.

Each monetization metric costs its own Graph call, so requesting both adds two calls. Values are approximate and Meta restates them later. The two are on different scales and not comparable. Both keep daily "values" on every metricType and are never rescaled by Zernio.

Earnings are Page-level daily buckets and "total" is their sum. Meta does not document whether a bucket is that day's earnings or a running total, and every Page measured so far earned exactly 0.

Reconcile "total" against the Page's Meta export before relying on it (daily "values" are always returned for this).

Per-post lifetime earnings: GET /v1/analytics/facebook/post-earnings.

A Page not enrolled in monetization, or that earned nothing, returns normal daily buckets of 0 in "metrics" (Meta does not distinguish them), so a 0 total does NOT mean the Page is enrolled.

"unavailableMetrics" covers the narrower case where Meta returned no bucket at all ("no_data") or rejected the request; the metric is then omitted from "metrics" rather than reported as 0.

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

End date (YYYY-MM-DD). Defaults to today.

Alias of fromDate, kept for existing callers

Alias of toDate, kept for existing callers

"total_value" (default) returns aggregated totals only. "time_series" returns daily values in the "values" array.