The Video API is a collection of Graph API endpoints that allow apps to publish existing videos on Pages administered by app users.
All requests are passed to the graph.facebook.com
host URL.
The graph-video.facebook.com
host for video uploads has been deprecated. Use the graph.facebook.com
host for API requests when uploading videos to Meta servers.
Upload videos using the Resumable Upload API.
The API uses the following nodes.
The Video node is the API's primary resource. When you upload an existing video the API generates a Video entity and publishes it on a Page. Videos must be published on a target node.
Videos can be published on a Page as long as the app user can perform admin-equivalent Tasks on the Page, or have been granted an Admin Role on the Page via the Business Manager.
Videos that have already been published can also be published on other Pages that the app user administers without having to be reuploaded. Insights on Crossposted Videos can be returned as aggregate values (e.g. the sum of all views across all Pages) or broken down by Page.
You can use the API to generate a slideshow Video from a collection of images hosted on a public server.
You can use the API to create Polls on published videos and get their results.
Published Videos can be used with the Marketing API's Ad Creative endpoint to create Video Ads.
You can get insights on any published Video. Insights for Crossposted Videos can be returned as aggregate values or broken down by Page.
You can receive real-time notifications of changes to a Video's publishing status and viewer interactions by setting up Page Webhooks. Set up a callback and then subscribe to the Page topic's feed
and videos
fields to receive notifications. Note that notification will not be sent for videos that are uploaded as secret
or no_story
.
For Videos published on a Page, you can use the Rights Manager API to create and apply copyright rules in order to discover other published Videos that may be in violation, and report them.
To publish on a Page, the app user must grant your app the pages_show_list
, pages_read_engagement
, and pages_manage_posts
permissions.
The app user must be able to perform the equivalent of ADMIN
tasks on the targeted Page.
All permissions require App Review.
The general flow for publishing a video on a Page is to: