This guide shows you how to get insights for a video that has been published on a Facebook Page.
Learn more about Reels Insights
You will need:
pages_read_engagement
Permission ANALYZE
task on the Page<VIDEO_ID>
for each Page it was posted to.Send a GET
request to the /<VIDEO_ID>/video_insights
endpoint to get total insights from all video posts associated with this video.
GET <API_VERSION>/<VIDEO_ID>/video_insights?access_token=<PAGE_ACCESS_TOKEN>"
curl -X GET \ "https://graph.facebook.com/v20.0/323790578640877/video_insights?access_token=EAABkW..."
{ "data": [ { "name": "total_video_views", "period": "lifetime", "values": [ { "value": 89 } ], "title": "Lifetime Total Video Views", "description": "Lifetime: Total number of times your video was viewed for 3 seconds or viewed to the end, whichever came first. (Total Count)", "id": "323790578640877/video_insights/total_video_views/lifetime" }, { "name": "total_video_views_unique", "period": "lifetime", "values": [ { "value": 56 } ], "title": "Lifetime Unique Video Views", "description": "Lifetime: Number of unique people who viewed your video for 3 seconds or viewed to the end, whichever came first. (Unique Users)", "id": "323790578640877/video_insights/total_video_views_unique/lifetime" }, { "name": "total_video_views_autoplayed", "period": "lifetime", "values": [ { "value": 23 } ], "title": "Lifetime Auto-Played Video Views", "description": "Lifetime: Number of times your video started automatically playing and people viewed it for 3 seconds or viewed it to the end, whichever came first. (Total Count)", "id": "323790578640877/video_insights/total_video_views_autoplayed/lifetime" }, { "name": "total_video_views_clicked_to_play", "period": "lifetime", "values": [ { "value": 12 } ], } ... ] }
Send a GET
request to the VideoVideoInsights endpoint with the metric
parameter and specific metrics you wish to receive.
GET /<API_VERSION>/<VIDEO_ID>/video_insights ?metric=total_video_views,total_video_views_unique &access_token=<PAGE_ACCESS_TOKEN>"
curl -X GET \ "https://graph.facebook.com/v20.0/323790578640877/video_insights?metric=total_video_views,total_video_views_unique&access_token=EAABkW..."
{ "data": [ { "name": "total_video_views", "period": "lifetime", "values": [ { "value": 2206 } ], "title": "Lifetime Total Video Views", "description": "Lifetime: Total number of times your video was viewed for 3 seconds or viewed to the end, whichever came first. (Total Count)", "id": "323790578640877/video_insights/total_video_views/lifetime" }, { "name": "total_video_views_unique", "period": "lifetime", "values": [ { "value": 6 } ], "title": "Lifetime Unique Video Views", "description": "Lifetime: Number of unique people who viewed your video for 3 seconds or viewed to the end, whichever came first. (Unique Users)", "id": "323790578640877/video_insights/total_video_views_unique/lifetime" } ] }