Changelog

Facebook Pages and related endpoints and fields will be made available for the new Pages experience in the future.

September, 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*

June 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*

March 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*

2021-06-21

  • The Page impressum field is now available.

2021-03-18

2020-10-02

Available Endpoints for the New Pages Experience

EndpointUnavailable 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}