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.  A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ.

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>"
  }
}

Request contract

Method and path: GET /apis/v1/social/analytics/facebook/page-insights
Availability: enabled
Request URL template: https://api.aisa.one/apis/v1/social/analytics/facebook/page-insights
accountId: query; required
metrics: query; optional
fromDate: query; optional
toDate: query; optional
since: query; optional
until: query; optional
metricType: query; optional
Runtime facts: 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd

Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

{
  "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"
      }
    }
  }
}

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}$

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>

default:total_value

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

Available options:

time_series,

total_value

Response

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>

Available options:

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.

Available options:

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

​Request contract

​Cost and request rules

Authorizations

Query Parameters

Response

Request contract

Cost and request rules