Analytics

Facebook Page metrics

A Page's audience, engagement on recent posts, and 28-day insights.

GEThttps://app.tryadeli.com/api/v1/analytics/facebook/page-metrics
AuthorizationBearer <API key>How keys work

Returns the Page's own details and audience size, engagement totalled across its recent posts, and Page Insights for the last 28 days.

Query parameters

accountIduuid
A connected Facebook Page. Defaults to the profile's Page.
profileIduuid
Required unless you pass accountId, which names its profile. If you pass both, they must agree.

insights

viewsnumber | null
Times the Page's content was on screen over the window (Meta's page_media_view), summed.
engagementsnumber | null
Reactions, comments, shares, and clicks on the Page's posts (page_post_engagements), summed.
pageViewsnumber | null
Visits to the Page itself (page_views_total), summed.
followersnumber | null
Followers on the latest day Meta reported (page_follows).
dailyarray
Daily views, oldest first, as { date, value }.

When insights is null

Page Insights need the read_insights permission. A Facebook connection made before Adeli requested it, or one where it was declined, returns "insights": null with "insightsUnavailable": "permission_missing"; reconnecting Facebook fixes it. "analyze_task_missing" means Meta refused even with the permission, because the person who connected the Page cannot view its insights. "provider_error" means Meta failed the request. The rest of the response is returned either way. A figure Meta did not report is null, not 0; small or new Pages often have none yet.

Errors — 401 unauthorized, 400 invalid_request, 404 account_not_found, 409 page_not_selected, 422 connection_expired, 422 provider_not_configured, 502 provider_error.