Get Facebook post monetization earnings

Returns lifetime monetization earnings for ONE Facebook post, read live from Meta on every request. Requires the Analytics add-on.

Earnings are CUMULATIVE since the post was published, not earnings within a date range, so this endpoint takes no since/until and the totals must not be summed across dates or across posts. Page-level daily earnings live on /v1/analytics/facebook/page-insights.

A post on a Page that is not enrolled in monetization, or that earned nothing, returns "total": 0 rather than an error: Meta does not distinguish the two. A metric Meta returned no bucket for at all is reported in "unavailableMetrics" and omitted from "metrics", never as a 0.

Amounts are the platform's raw numbers in the stated "unit" and are never rescaled by Zernio. Breakdown dimensions are not exposed and a "breakdown" param is rejected with 400. So are "since", "until", "period", and "metricType": scoping this endpoint to a window is not possible, and silently returning the lifetime total for one would let a caller sum a year of weekly requests into a figure ~52x the post's real earnings.

accountIdstring required

The Zernio SocialAccount ID for the connected Facebook Page.

postIdstring required

The platform post ID, exactly as returned in platformAnalytics[].platformPostId by /v1/analytics: "{pageId}_{postId}", or the bare video ID for Reels.

metricsstring

Comma-separated list of monetization metrics. Defaults to both:

content_monetization_earnings
monetization_approximate_earnings

content_monetization_earnings always carries unit "micro_amount" plus an ISO 4217 "currency". monetization_approximate_earnings is always a bare number, so its unit is "unspecified" and its "currency" is null. The two are on different scales and are not comparable to each other. Any other metric name is rejected with 400.

Response

Lifetime per-post monetization earnings

successboolean

accountIdstring

postIdstring

The platform post ID that was queried, echoed back.

platformstring

period'lifetime'

Always "lifetime": the total is cumulative since publication and must not be summed across dates or across posts.

metricsobject

One entry per served metric. A metric reported here with "total": 0 genuinely earned nothing (or its Page is not enrolled, which Meta reports identically).

dataDelaystring

Example response

{
  "success": true,
  "accountId": "64e1a2b3c4d5e6f7a8b9c0d1",
  "postId": "123456789_987654321",
  "platform": "facebook"
}

v2

Get Facebook post monetization earnings

Query parameters

Response

Example response