Get Facebook Page insights

curl --request GET \
  --url https://api.aisa.one/apis/v1/social/analytics/facebook/page-insights \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.aisa.one/apis/v1/social/analytics/facebook/page-insights"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aisa.one/apis/v1/social/analytics/facebook/page-insights', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/social/analytics/facebook/page-insights",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/social/analytics/facebook/page-insights"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/social/analytics/facebook/page-insights")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "accountId": "<string>",
  "breakdown": "<string>",
  "dataDelay": "<string>",
  "dateRange": {
    "since": "2023-12-25",
    "until": "2023-12-25"
  },
  "metricType": "time_series",
  "metrics": {},
  "platform": "facebook",
  "success": true,
  "unavailableMetrics": [
    {
      "message": "<string>",
      "metric": "<string>",
      "reason": "not_enrolled"
    }
  ]
}

{
  "error": {
    "code": "<string>",
    "details": {},
    "message": "<string>",
    "param": "<string>",
    "retryHint": "never",
    "retryable": true,
    "type": "<string>"
  }
}

AIsa Social

Get Facebook Page insights

Analytics. Read only; needs social:read. Ids are yours: accounts acc_..., profiles prf_..., posts pst_...; every other object id is checked against your accounts before the call. Returns page-level Facebook insights (media views, views, post engagements, video metrics, follower counts). The response shape matches /apis/v1/social/analytics/instagram/account-insights, so the same client handling works across platforms. Max 89 days, defaults to last 30 days. ### Metric names Metric names track the current (post-November 2025) Meta Graph API. These legacy metrics were deprecated by Meta on November 15, 2025 and are NOT accepted by this endpoint: - page_impressions - page_fans - page_fan_adds - page_fan_removes Use the replacements below. Because Meta did not provide direct adds/removes replacements, AIsa synthesizes followers_gained / followers_lost from the daily follower snapshotter.  当前未提供请求参考价格；请使用接口支持的报价功能确认费用。最终费用以账户适用价格及实际结算为准。

GET

https://api.aisa.one

apis

social

analytics

facebook

page-insights

Get Facebook Page insights

curl --request GET \
  --url https://api.aisa.one/apis/v1/social/analytics/facebook/page-insights \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.aisa.one/apis/v1/social/analytics/facebook/page-insights"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aisa.one/apis/v1/social/analytics/facebook/page-insights', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/social/analytics/facebook/page-insights",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/social/analytics/facebook/page-insights"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/social/analytics/facebook/page-insights")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "accountId": "<string>",
  "breakdown": "<string>",
  "dataDelay": "<string>",
  "dateRange": {
    "since": "2023-12-25",
    "until": "2023-12-25"
  },
  "metricType": "time_series",
  "metrics": {},
  "platform": "facebook",
  "success": true,
  "unavailableMetrics": [
    {
      "message": "<string>",
      "metric": "<string>",
      "reason": "not_enrolled"
    }
  ]
}

{
  "error": {
    "code": "<string>",
    "details": {},
    "message": "<string>",
    "param": "<string>",
    "retryHint": "never",
    "retryable": true,
    "type": "<string>"
  }
}

请求规范

方法与路径: GET /apis/v1/social/analytics/facebook/page-insights
可用状态: enabled
请求 URL 模板: https://api.aisa.one/apis/v1/social/analytics/facebook/page-insights
accountId: query; 必填
metrics: query; 可选
fromDate: query; 可选
toDate: query; 可选
since: query; 可选
until: query; 可选
metricType: query; 可选
Runtime 事实版本: 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd

完整 OpenAPI 定义有效请求与价格声明（包括认证和引用的 schema）：

{
  "operationId": "get_aisa_social_apis_v1_social_analytics_facebook_ee35af",
  "method": "GET",
  "path": "/apis/v1/social/analytics/facebook/page-insights",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [
    {
      "description": "One of your social accounts (acc_...).",
      "in": "query",
      "name": "accountId",
      "required": true,
      "schema": {
        "pattern": "^acc_[0-9A-Za-z]{22}$",
        "type": "string"
      }
    },
    {
      "description": "Comma-separated list of metrics. Defaults to \"page_media_view,page_post_engagements,page_follows,followers_gained,followers_lost\".\n\n**Live Meta metrics** (current names, post-Nov-2025):\n\n- page_media_view (replaces deprecated page_impressions)\n- page_views_total\n- page_post_engagements\n- page_video_views\n- page_video_view_time\n- page_follows (replaces deprecated page_fans)\n\n**AIsa-synthesized** from daily follower snapshots (filling the Nov-2025 gap left by the page_fan_adds / page_fan_removes deprecation):\n\n- followers_gained\n- followers_lost\n\n**Monetization** (opt-in, not in the defaults):\n\n- content_monetization_earnings: an object per day, always with unit \"micro_amount\" and an ISO 4217 \"currency\".\n- monetization_approximate_earnings: a bare number per day; unit is always \"unspecified\" and \"currency\" always null.\n\nEach 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 AIsa.\n\nEarnings 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.\n\nReconcile \"total\" against the Page's Meta export before relying on it (daily \"values\" are always returned for this).\n\nPer-post lifetime earnings: GET /apis/v1/social/analytics/facebook/post-earnings.\n\nA 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.\n\n\"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.",
      "in": "query",
      "name": "metrics",
      "required": false,
      "schema": {
        "type": "string"
      }
    },
    {
      "description": "Start date (YYYY-MM-DD). Defaults to 30 days ago.",
      "in": "query",
      "name": "fromDate",
      "required": false,
      "schema": {
        "format": "date",
        "type": "string"
      }
    },
    {
      "description": "End date (YYYY-MM-DD). Defaults to today.",
      "in": "query",
      "name": "toDate",
      "required": false,
      "schema": {
        "format": "date",
        "type": "string"
      }
    },
    {
      "description": "Alias of fromDate, kept for existing callers",
      "in": "query",
      "name": "since",
      "required": false,
      "schema": {
        "format": "date",
        "type": "string"
      }
    },
    {
      "description": "Alias of toDate, kept for existing callers",
      "in": "query",
      "name": "until",
      "required": false,
      "schema": {
        "format": "date",
        "type": "string"
      }
    },
    {
      "description": "\"total_value\" (default) returns aggregated totals only.\n\"time_series\" returns daily values in the \"values\" array.",
      "in": "query",
      "name": "metricType",
      "required": false,
      "schema": {
        "default": "total_value",
        "enum": [
          "time_series",
          "total_value"
        ],
        "type": "string"
      }
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "x-aisa-status": "enabled",
  "x-aisa-pricing": {
    "description": "Included with your connected social accounts: AIsa does not charge per call.",
    "kind": "no_customer_charge"
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}

费用与请求规则

当前未提供请求参考价格；请使用接口支持的报价功能确认费用。最终费用以账户适用价格及实际结算为准。公开参考值不是你的账户报价或最终扣费。对于支持 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}$

metrics

string

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)

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

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 /apis/v1/social/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.

fromDate

string<date>

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

toDate

string<date>

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

since

string<date>

Alias of fromDate, kept for existing callers

until

string<date>

Alias of toDate, kept for existing callers

metricType

enum<string>

默认值:total_value

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

可用选项:

time_series,

total_value

响应

Page insights data

Shared account-insights response envelope used by every platform-level analytics endpoint (/apis/v1/social/analytics/{facebook|instagram|youtube|linkedin|tiktok}/*). The name is historical - the shape was first shipped for Instagram and every new platform endpoint reuses it for response-shape consistency. The platform field echoes back which platform served the response.

accountId

string

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

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

breakdown

string

Breakdown dimension used (only present when breakdown was requested)

dataDelay

string

dateRange

object

Show child attributes

metricType

enum<string>

可用选项:

time_series,

total_value

metrics

object

Object keyed by metric name.

For time_series: each metric has "total" (number) and "values" (array of {date, value}).
For total_value: each metric has "total" (number) and optionally "breakdowns" (array of {dimension, value}).

Monetary metrics also carry "unit" and "currency". AIsa never rescales money: "total" and every "values[].value" are the platform's raw numbers in the stated unit.

Monetary metrics keep "values" even on metricType=total_value, because their "total" is the sum of the daily buckets the platform returned over the range. Keep the series to reconcile that sum against the platform's own reporting before invoicing on it.

A metric that could not be served is absent from this object and listed in "unavailableMetrics" instead, so an unavailable metric is never reported as a zero.

Show child attributes

platform

enum<string>

Platform that served this response.

可用选项:

facebook,

instagram,

youtube,

linkedin,

tiktok

success

boolean

unavailableMetrics

object[]

Requested metrics that could not be served. Present only when at least one metric is unavailable, absent otherwise.

Each listed metric is OMITTED from "metrics" rather than reported as 0, which is how an unavailable metric is distinguished from a genuine zero. The request itself still succeeds with HTTP 200.

Show child attributes

​请求规范

​费用与请求规则

授权

查询参数

响应

请求规范

费用与请求规则