Skip to main content
GET
Get Facebook post monetization earnings

Request contract

  • Method and path: GET /apis/v1/social/analytics/facebook/post-earnings
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/social/analytics/facebook/post-earnings
  • accountId: query; required
  • postId: query; required
  • metrics: query; optional
  • Runtime facts: 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

accountId
string
required

One of your social accounts (acc_...).

Pattern: ^acc_[0-9A-Za-z]{22}$
postId
string
required

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

metrics
string

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

Lifetime monetization earnings for one Facebook post. Same "unit" / "currency" contract and same unavailable-vs-zero contract as the Page-level response; there is no date range, no metricType, and no daily "values", because the single lifetime bucket IS the total.

accountId
string

One of your social accounts (acc_...).

Pattern: ^acc_[0-9A-Za-z]{22}$
dataDelay
string
metrics
object

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).

period
enum<string>

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

Available options:
lifetime
platform
string
postId
string

The platform post ID that was queried, echoed back.

success
boolean
unavailableMetrics
object[]

Requested metrics Meta could not serve. Present only when at least one metric is unavailable, and absent otherwise. Each listed metric is OMITTED from "metrics" rather than reported as 0. The request itself still succeeds with HTTP 200.