https://graph-video.facebook.com
— Used exclusively for publishing videos on Pages and Groups.https://graph.facebook.com
— Used for everything else (creating polls, getting insights, etc.).The API supports both Resumable and Non-Resumable Upload protocols. The Resumable Upload protocol is used for sequentially uploading video chunks while the Non-Resumable Protocol is used for uploading complete videos. We recommend using the Resumable Upload protocol because it supports larger video files and allows you to handle connection interruptions more efficiently.
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 either a Page or Group, depending on the node you target when you begin the publishing process. Videos must be published on a target node.
Videos can be published on a Group as long as the app has the appropriate Permissions and Features. In addition, the app user must be able to perform admin-equivalent Tasks on the Page, or have been granted an Admin Role on the Page via the Business Manager.
Videos can be published on a Group as long as the app has the appropriate Permissions and Features and the app user is an Admin of the Group.
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.
For Videos published on Pages, 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 Management 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.
To publish on a Group, the app user must grant your app the publish_to_groups
Permission.
No Features are required to publish on a Page. To publish on a Group, your app must be approved for the Groups API Feature.
The app user must be able to perform the equivalent of ADMIN
tasks on the targeted Page, or be an Admin of the targeted Group.
All Permissions and Features require App Review.
The general flow for publishing a Video on a Page or Group is to: