Facebook Pages API Release Notes

Page Insights API Updates

Applies to all versions.

On November 15, 2025, a number of the Page Insights metrics will be deprecated for all API versions. The API will return an invalid metric error when calling any of these metrics.

• page_fans (Alternative: page_follows)
• Page_fans_locale
• Page_fans_city (Alternative: page_follows_city)
• Page_fans_country (Alternative: page_follows_country)
• Page_fan_adds
• Page_fan_adds_unique
• Page_fan_removes
• page_fan_removes_unique*
• page_impressions* (Alternative: page_media_view)
• page_impressions_paid* (Alternative: page_media_view with is_from_ads breakdown)
• page_impressions_viral*
• page_impressions_nonviral*
• post_impressions* (Alternative: post_media_view)
• post_impressions_paid* (Alternative: post_media_view with is_from_ads breakdown)
• post_impressions_fan* (Alternative: post_media_view with is_from_followers breakdown)
• post_impressions_organic* (Alternative: post_media_view with is_from_ads breakdown)
• post_impressions_viral*
• post_impressions_nonviral*

Original source Report a problem

Page Insights API Updates

Applies to all versions.

The following Page Insights metrics have been deprecated for all API versions. The API returns an invalid metric error when calling any of these metrics.

• page_call_phone_clicks_logged_in_by_locale_unique
• page_call_phone_clicks_logged_in_count
• page_call_phone_clicks_logged_in_unique
• page_consumptions_by_consumption_type
• page_consumptions_by_consumption_type_unique
• page_consumptions_unique
• page_cta_clicks_logged_in_total
• page_cta_clicks_logged_in_unique
• page_daily_follows_by_paid_non_paid_unique
• page_daily_follows_by_source
• page_daily_follows_by_source_unique
• page_daily_unfollows_by_source
• page_daily_unfollows_by_source_unique
• page_fans_by_like_source
• page_fans_by_like_source_unique
• page_fans_by_unlike_source
• page_fans_by_unlike_source_unique
• page_fans_online
• page_fans_online_per_day
• page_get_directions_clicks_logged_in_count
• page_get_directions_clicks_logged_in_unique
• page_impressions_by_age_gender_unique
• page_impressions_by_city_unique
• page_impressions_by_country_id_unique
• page_impressions_by_country_unique
• page_impressions_by_locale_unique
• page_impressions_by_paid_non_paid
• page_impressions_by_paid_non_paid_unique
• page_impressions_by_story_type
• page_impressions_by_story_type_unique
• page_impressions_organic_unique_v2
• page_impressions_organic_v2
• page_impressions_frequency_distribution
• page_impressions_viral_frequency_distribution
• page_negative_feedback
• page_negative_feedback_by_type
• page_negative_feedback_by_type_unique
• page_negative_feedback_unique
• page_places_checkin_total
• page_places_checkin_total_unique
• page_palces_checkins_by_age_gender
• page_places_checkins_by_city
• page_places_checkins_by_country
• page_places_checkins_by_locale
• page_posts_impressions_by_paid_non_paid
• page_posts_impressions_by_paid_non_paid_unique
• page_posts_impressions_frequency_distribution
• page_posts_impressions_organic
• page_posts_impressions_organic_unique
• page_posts_impressions_organic_v2 (on hold)
• page_story_adds_by_country_unique
• page_tab_views_login_top
• page_tab_views_login_top_unique
• page_tab_views_logout_top
• page_views
• page_views_external_referrals
• page_views_login_unique
• page_views_login
• page_views_logout
• page_views_unique
• page_website_clicks_logged_in_by_city_unique
• page_website_clicks_logged_in_by_country_unique
• page_website_clicks_logged_in_by_locale_unique
• page_website_clicks_logged_in_count
• page_website_clicks_logged_in_unique
• post_clicks_unique*
• post_clicks_by_type_unique
• post_cta_clicks_by_type
• post_cta_clicks_total
• post_engaged_fan
• post_engaged_users*
• post_impressions_by_paid_non_paid
• post_impressions_by_story_type*
• post_impressions_by_story_type_unique*
• post_negative_feedback*
• post_negative_feedback_by_type*
• post_negative_feedback_by_type_unique*
• post_negative_feedback_unique*

Original source Report a problem

Page Insights API Updates

Applies to all versions. On September 16, 2024, a number of the Page Insights metrics will be deprecated for all API versions. The API will return an invalid metric error when calling any of these metrics.

• page_call_phone_clicks_logged_in_by_locale_unique
• page_call_phone_clicks_logged_in_count
• page_call_phone_clicks_logged_in_unique
• page_consumptions_by_consumption_type
• page_consumptions_by_consumption_type_unique
• page_consumptions_unique
• page_cta_clicks_logged_in_total
• page_cta_clicks_logged_in_unique
• page_daily_follows_by_paid_non_paid_unique
• page_daily_follows_by_source
• page_daily_follows_by_source_unique
• page_daily_unfollows_by_source
• page_daily_unfollows_by_source_unique
• page_fans_by_like_source
• page_fans_by_like_source_unique
• page_fans_by_unlike_source
• page_fans_by_unlike_source_unique
• page_fans_online
• page_fans_online_per_day
• page_get_directions_clicks_logged_in_count
• page_get_directions_clicks_logged_in_unique
• page_impressions_by_age_gender_unique
• page_impressions_by_city_unique
• page_impressions_by_country_id_unique
• page_impressions_by_country_unique
• page_impressions_by_locale_unique
• page_impressions_by_paid_non_paid
• page_impressions_by_paid_non_paid_unique
• page_impressions_by_story_type
• page_impressions_by_story_type_unique
• page_impressions_organic_unique_v2
• page_impressions_organic_v2
• page_impressions_frequency_distribution
• page_impressions_viral_frequency_distribution
• page_negative_feedback
• page_negative_feedback_by_type
• page_negative_feedback_by_type_unique
• page_negative_feedback_unique
• page_places_checkin_total
• page_places_checkin_total_unique
• page_palces_checkins_by_age_gender
• page_places_checkins_by_city
• page_places_checkins_by_country
• page_places_checkins_by_locale
• page_positive_feedback_by_type_unique
• page_positive_feedback_by_type
• page_positive_feedback_unique
• page_positive_feedback
• page_posts_impressions_frequency_distribution
• page_views_by_age_gender_logged_in_unique
• page_views_by_city_logged_in_unique
• page_views_by_country_logged_in_unique
• page_views_by_internal_referer_logged_in_unique
• page_views_by_locale_logged_in_unique
• page_views_by_profile_tab_logged_in_unique
• page_views_by_profile_tab_total
• page_views_by_referers_logged_in_unique
• page_views_by_site_logged_in_unique
• page_views_external_referrals
• page_views_logged_in_total
• page_views_logged_in_unique
• page_views_login_unique
• page_views_login
• page_views_logout
• page_views_unique
• page_website_clicks_by_age_gender_logged_in_unique
• page_website_clicks_by_site_logged_in_unique
• page_website_clicks_logged_in_by_city_unique
• page_website_clicks_logged_in_by_country_unique
• page_website_clicks_logged_in_by_locale_unique
• post_activity
• post_activity_by_action_type (deleted)
• post_activity_by_action_type_unique (deleted)
• post_activity_unique
• post_impressions_fan_paid_unique*
• post_impressions_fan_paid*

Original source Report a problem

Additional endpoints

Additional endpoints are now available for the new Pages experience.

POST /{album-id} POST /{canvas-button-id} POST /{canvas-carousel-id} POST /{canvas-text-id} DELETE /{comment-id}/likes GET /{comment-id}/reactions GET /{lead-id} GET /{link-id}/comments /{media-fingerprint-id} DELETE /{page-id}/blocked /{page-id}/copyright_whitelisted_partners /{page-id}?fields=copyright_whitelisted_ig_partners GET /{page-id}/crosspost_whitelisted_pages

• POST /{album-id}
• POST /{canvas-button-id}
• POST /{canvas-carousel-id}
• POST /{canvas-text-id}
• DELETE /{comment-id}/likes
• GET /{comment-id}/reactions
• GET /{lead-id}
• GET /{link-id}/comments
• /{media-fingerprint-id}
• DELETE /{page-id}/blocked
• /{page-id}/copyright_whitelisted_partners
• /{page-id}?fields=copyright_whitelisted_ig_partners
• GET /{page-id}/crosspost_whitelisted_pages

POST /{page-id}/picture GET /{page-id}/roles /{page-id}/settings GET /{pagepost-id}/to DELETE /{photo-id} GET /{photo-id}/likes GET /{photo-id}/picture DELETE /{post-id}/likes POST /{video-id}/thumbnails

• POST /{page-id}/picture
• GET /{page-id}/roles
• /{page-id}/settings
• GET /{pagepost-id}/to
• DELETE /{photo-id}
• GET /{photo-id}/likes
• GET /{photo-id}/picture
• DELETE /{post-id}/likes
• POST /{video-id}/thumbnails

Original source Report a problem

Facebook begins migrating select Pages to the new Pages experience

Available Endpoints for the New Pages Experience

Endpoint Unavailable Fields /{comment-id} /{comment-id}/comments /{live-video-id} /{media-fingerprint-id} /{page-id}/conversations /{page-id}/copyright_whitelisted_partners /{page-id}/feed GET fields: child_attachments feed_targeting scheduled_publish_time POST fields: backdated_time_granularity child_attachments feed_targeting multi_share_end_card multi_share_optimized published scheduled_publish_time /{page-id}/live_videos /{page-id}/media_fingerprints /{page-id}/posts /{page-id}/promotable_posts GET fields: child_attachments feed_targeting /{page-id}/videos /{page-id}/videos GET /{page-name}/feed GET /{page-name}/posts /{pagepost-id} GET fields: backdated_time child_attachments feed_targeting scheduled_publish_time /{pagepost-id}/comments /{pagepost-id}/likes /{pagepost-id}/reactions /{post-id} /{post-id}/comments /{post-id}/reactions GET /{user-id}/accounts /{video-id} /{video-id}/video_insights /{video_copyright_rule-id} Original source Report a problem