跳转到主要内容
GET
Get Facebook post monetization earnings

请求规范

  • 方法与路径: GET /apis/v1/social/analytics/facebook/post-earnings
  • 可用状态: enabled
  • 请求 URL 模板: https://api.aisa.one/apis/v1/social/analytics/facebook/post-earnings
  • accountId: query; 必填
  • postId: query; 必填
  • metrics: query; 可选
  • Runtime 事实版本: 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd
完整 OpenAPI 定义 有效请求与价格声明(包括认证和引用的 schema):

费用与请求规则

当前未提供请求参考价格;请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。 公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口,执行前请针对完整请求获取免费报价;执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。

授权

Authorization
string
header
必填

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

查询参数

accountId
string
必填

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

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

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.

响应

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.

可用选项:
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.