Pages API
Changelog
Updated: Jan 30, 2026
Get notified
Changelog (10)
Jan 30, 2026

[New] Page Integrity API

You can now get real-time integrity information for a page via the Page Integrity Webhook and API. This includes the integrity status, violations, restrictions, recommended actions (e.g. file an appeal) and appeal status.
Nov 15, 2025

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. Learn more.
  • 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*
Sep 16, 2024

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*
Jun 17, 2024

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. Learn more.
  • 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*
Mar 14, 2024

Page Insights Metrics Deprecation


Applies to all versions.
On March 14, 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. Learn more.

December 14, 2023

Page Insights Metrics Deprecation


Applies to all versions on March 14, 2024.
On March 14, 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. Learn more.
  • page_actions_post_reactions_anger_total
  • page_actions_post_reactions_haha_total
  • page_actions_post_reactions_like_total
  • page_actions_post_reactions_love_total
  • page_actions_post_reactions_sorry_total
  • page_actions_post_reactions_total
  • page_actions_post_reactions_wow_total
  • page_call_phone_clicks_by_age_gender_logged_in_unique
  • page_call_phone_clicks_by_site_logged_in_unique
  • page_call_phone_clicks_logged_in_by_city_unique
  • page_call_phone_clicks_logged_in_by_country_unique
  • page_call_phone_clicks_logged_in_by_locale_unique
  • page_consumptions
  • page_content_activity
  • page_content_activity_by_action_type
  • page_content_activity_by_action_type_unique
  • page_content_activity_by_age_gender_unique
  • page_content_activity_by_city_unique
  • page_content_activity_by_country_unique
  • page_content_activity_by_locale_unique
  • page_content_activity_unique
  • page_cta_clicks_by_age_gender_logged_in_unique
  • page_cta_clicks_by_site_logged_in_unique
  • page_cta_clicks_logged_in_by_city_unique
  • page_cta_clicks_logged_in_by_country_unique
  • page_cta_clicks_logged_in_by_locale_unique
  • page_daily_follows_by_source_unique
  • page_daily_unfollows_by_source_unique
  • page_engaged_users
  • page_fans_by_like_source_unique
  • page_fans_by_like_source
  • page_fans_by_unlike_source_unique
  • page_fans_by_unlike_source
  • page_fans_gender_age
  • page_follows_city
  • page_follows_country
  • page_follows_gender_age
  • page_follows_locale
  • page_get_directions_clicks_by_age_gender_logged_in_unique
  • page_get_directions_clicks_by_site_logged_in_unique
  • page_get_directions_clicks_logged_in_by_city_unique
  • page_get_directions_clicks_logged_in_by_country_unique
  • page_impressions_frequency_distribution
  • page_places_checkin_mobile_unique
  • page_places_checkin_mobile
  • page_places_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_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
  • post_activity_by_action_type_unique
  • post_activity_unique
  • post_impressions_fan_paid_unique*
  • post_impressions_fan_paid*
Jun 21, 2021

  • The Page impressum field is now available.
Mar 18, 2021

Oct 2, 2020

Available Endpoints for the New Pages Experience

Endpoint Unavailable Fields
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
GET fields:
  • child_attachments
  • feed_targeting
GET fields:
  • backdated_time
  • child_attachments
  • feed_targeting
  • scheduled_publish_time