{
  "schema_version": "1.7.0",
  "id": "x_SHAPI-meta-graph-page-insights-impressions-fans-removed",
  "modified": "2026-10-31T01:21:29Z",
  "published": "2025-08-15T00:00:00Z",
  "summary": "Page Insights impressions and page fans metrics removed on 2025-11-15",
  "details": "Since 2025-11-15, on all API versions, requesting the Page and post impressions metrics (page_impressions, page_impressions_paid, page_impressions_viral, page_impressions_nonviral, post_impressions, post_impressions_paid, post_impressions_fan, post_impressions_organic, post_impressions_viral, post_impressions_nonviral) or the fans metrics (page_fans, page_fans_locale, page_fans_city, page_fans_country, page_fan_adds, page_fan_adds_unique, page_fan_removes, page_fan_removes_unique) returns an invalid metric error. SHAPI flags calls that request one of these metrics.\n\nReplace page_impressions with page_media_view and post_impressions with post_media_view (use the is_from_ads or is_from_followers breakdowns for the paid, organic and fan splits), and replace page_fans/page_fans_city/page_fans_country with page_follows/page_follows_city/page_follows_country. Remove the other listed metrics; one invalid metric fails the whole insights request.",
  "affected": [
    {
      "ecosystem_specific": {
        "provider": "meta-graph",
        "endpoint": {
          "method": "GET",
          "path": "/**/insights"
        },
        "change_class": "version-sunset",
        "trigger": {
          "query": [
            {
              "name": "metric",
              "values": [
                "page_fans",
                "page_fans_locale",
                "page_fans_city",
                "page_fans_country",
                "page_fan_adds",
                "page_fan_adds_unique",
                "page_fan_removes",
                "page_fan_removes_unique",
                "page_impressions",
                "page_impressions_paid",
                "page_impressions_viral",
                "page_impressions_nonviral",
                "post_impressions",
                "post_impressions_paid",
                "post_impressions_fan",
                "post_impressions_organic",
                "post_impressions_viral",
                "post_impressions_nonviral"
              ]
            }
          ]
        },
        "effective_date": "2025-11-15"
      }
    }
  ],
  "references": [
    {
      "type": "ADVISORY",
      "url": "https://developers.facebook.com/blog/post/2025/08/15/page-insights-api-updates/"
    },
    {
      "type": "WEB",
      "url": "https://developers.facebook.com/docs/platforminsights/page/deprecated-metrics"
    }
  ],
  "database_specific": {
    "severity": "critical",
    "status": "verified",
    "url": "https://shapi.dev/osv/meta-graph-page-insights-impressions-fans-removed.json"
  }
}