Home
Blog
Page Insights API Updates

August 15, 2025

Page Insights API Updates

By Li-Fu Lin

Beginning November 15, 2025, we’re deprecating the ‘impressions’ and ‘page fans’ metrics from the Page Insights API. This is in line with our continued efforts to align the functionality of the Page Insights API with that of the Facebook app and Meta Business Suite.

See below for details that are relevant to the developer community. These changes include notifications on deprecations that we believe are relevant to your application(s)’ integration with our platform.

For a complete list of all changes and their details, please visit our changelog.

Deprecations & Breaking Changes

Page Insights API changes - metrics deprecation

To continue to align the functionality of the Page Insights API with the Facebook app and Meta Business Suite, we’re deprecating the `impressions` metric. This metric will be replaced by the `views` metric on all API versions.

Additionally, with the migration of all Facebook Pages to the new Pages experience, the Page Insights tab for classic Pages has been fully deprecated as of November 1, 2023. As part of this deprecation, we are deprecating the `page fans` metrics.

We are providing a 90-day notice to developers that these deprecations will be implemented on November 15, 2025, to give ample time to make any changes that are needed in preparation for this update. Once they are deprecated, the API will return an invalid metric error when calling any of these metrics. To avoid disruption to your business, please review the list of deprecated metrics to ensure your business transitions from using these.

For more comprehensive information and detailed implementation guidelines, please refer to our developer documentation.


Get our newsletter

Sign up for monthly updates from Meta for Developers.

Sign up