Facebook Pages
Description
Facebook Pages is a platform where people can connect with brands, businesses, and organizations. It's a place to build real connections and real relationships with customers.
Setup guide
Follow our setup guide to connect Facebook Pages to Improvado.
- Click the Make a new Connection on the Connections page.
Categories on the Data sources page group all available platforms. Use a search to find the required one. - Click on the Facebook Pages tile.
- Authorize your Facebook account via OAuth. Before authorization, please, make sure that you are signed in to the account you want to extract data from.
- Grant Improvado access to your name and profile picture and your permission to:
| Permission | Additional information |
|---|---|
| Manage | Ads for ad accounts that you have access to |
| Your business | |
| Access | Your Facebook ads and related stats |
| Create and manage | Ads for your Page |
| Read | Content posted on the Page |
| User content on your Page | |
| Show | List of the Pages you manage |
Note: All required permissions are mandatory. If you limit any permission - it could cause connection errors!
- After the connection process is completed successfully, the Facebook Pages connection will appear in your Connected sources list.
- When the connection status is Active, and the account status column shows a number of accounts, you can move on to data extraction.
- To extract data from the connected sources, check the instruction on how to set up data extraction.
Schema information
The schema information shows all report types you can use to extract data from Facebook Pages.
Troubleshooting
Video metrics return 0 or blank in Facebook Pages reports
Symptom. Video and Reel metrics come back as 0 or empty, while the same numbers are visible in Facebook’s own Page Insights. Other metrics in the same report populate normally, and the extraction reports no error. Typically some videos still show data while others are blank, rather than the whole report going empty.
Affected reports. Only fields that come from Meta’s Video Insights API:
- Videos — Total Video Views, Organic and Paid Video Views, Total Video Complete Views, Total 10-Second Views, Reel Play Count, Average Time Reel Viewed, Total Reel View Time, and the reaction and action breakdowns on Reels.
- Videos by Region — Total Video View Time, along with the Country and Region dimensions derived from it.
Page-level and post-level reports are not affected. Their video metrics, such as Post Video Views on the Post and Published Post reports, come from a different Graph API edge that does not require this permission.
Cause. From November 2025, Meta requires the pages_manage_engagement permission, in addition to read_insights, to return data from the Video Insights API. A connection authorized without it receives zeros rather than a permission error, which is why the failure is silent and surfaces only as missing numbers in a report.
This is a Meta requirement rather than an Improvado limitation. The pages_manage_engagement permission covers both managing comments on a Page and access to video statistics, so Facebook requires it to return video insights even though your use of the data is read-only. Facebook’s consent screen names the comment-management side, which is why the permission can look unrelated to analytics. Improvado requests it solely to read video insights and performs no moderation actions on your Page.
Resolution. The pages_manage_engagement permission is included in the Read & Write permission level. Open the connection in your Connected sources list and re-authorize it with that level.
It is a write-level permission, so it is deliberately not part of Read Only — a Read Only connection cannot return video metrics. If you use Custom permissions, select pages_manage_engagement explicitly alongside the scopes you already use.
Permissions are recorded at the moment a connection is created, so an existing connection keeps whatever it was originally granted — including connections already set to Read & Write, which were authorized before this permission was added to that level. Re-authorizing is required even if the connection is otherwise healthy and shows as Active.
Historical data. After reconnecting, re-run the extraction over the affected date range to collect video views for periods that were extracted under the old permission set.
Limits
Meta deletes Live videos after 30 days
Since February 2025 Meta removes Facebook Live videos 30 days after publication. Once a video is gone from Meta it cannot be returned by the API, so no connector can fetch it and no re-extraction will bring it back.
What that means for your data depends on how the report type stores its rows, and the two behave very differently:
- Snapshot report types replace their contents on every run. They describe what exists in Meta right now, so a Live video disappears from them the moment Meta deletes it — including from the historical rows you already had.
- Incremental report types append to what is already stored. Rows extracted while the video still existed stay in your warehouse after Meta removes it.
On Facebook Pages that pair is Post Insights Lifetime, which is a snapshot, and Post Insights Lifetime Incremental, which is not. Their in-product descriptions do not spell the difference out, so it is worth stating plainly: if Live video history matters to your reporting, extract it with the incremental report, and run the extraction often enough to catch each video inside its 30-day window. Relying on the snapshot report for Live history will quietly lose it.
The same asymmetry applies to any content deleted on the Meta side, not only Live videos — a deleted post leaves a snapshot report and stays in an incremental one.
Release notes
You can find information about the latest API changes in the official Release notes.
Was this article helpful?
Thanks for the feedback!