Introducing a New Metric to the Page Insights API

As Pages grow in size and relevance for businesses, it becomes increasingly important for them to track how their content performs across the Facebook platform. Based on partner feedback, we’ve identified the need to include more robust insights about crossposted and shared videos, which will now be available via the new metric: page_video_views_by_uploaded_hosted.

This metric will give businesses the ability to understand the view count of videos posted, shared, or crossposted to their own Page in addition to their videos that are shared or crossposted to other Pages.

All existing filters for the /insights endpoint, (i.e. date range) will still be available and can be added to the request.

The response has the following structure:

          {
    "data": [
        {
            "name": "page_video_views_by_uploaded_hosted",
            "period": "{period}",
            "values": [
                {
                    "value": {
                        "page_uploaded": 0,
                        "page_uploaded_from_crossposts": 0,
                        "page_uploaded_from_shares": 0,
                        "page_hosted_crosspost": 0,
                        "page_hosted_share": 0,
                        "page_owned": 0
                    },
                    "end_time": "2022-10-02T07:00:00+0000"
                }
            ],
            "title": {title},
            "description": "{description}",
            "id": "{page_id}/insights/{metric_name}/{period}"
        }
    ],
    "paging": {
        "previous": {link_to_previous},
        "next": {link_to_next},
    }
}
        

Understanding the Response

The new metric brings many fields in a single response, you can guide yourself with these equivalences:

• page_uploaded: Views of videos posted by your Page, including shares and crossposts of them to other pages
• page_uploaded_from_crossposts: Views of videos crossposted to other pages
• page_uploaded_from_shares: Views of videos shared to other pages
• page_hosted_crosspost: Views on your Page of videos that have been crossposted from other pages
• page_hosted_share: Views on your Page of videos that have been shared from other pages
• page_owned: Views on your Page of videos that were originally posted on your Page

This new metric will facilitate getting a better understanding of how your content is being consumed among your Page and other pages it was crossposted or shared to.

Additional resources

If you have not yet integrated with the Page Insights API, here are some resources and guides to get started:

• Page Insights API documentation - Developer documentation with all the details of the API
• Get Started with the Pages Insights API Blog Post - Blog Post detailing instructions on how to get started with the API
• Insights API Sample Dashboard on GitHub - Sample Dashboard repository that integrates the Page Insights API to show a possible built product