Specifications, Branded Content, and Copyright

Video Specifications

Note: Live videos must have both an audio and a video track or the live video won't work.

Video Format

  • Video with a maximum 720p (1280x720) resolution at 30 frames per second, with 1 key frame every 2 seconds.
  • An I-frame (keyframe) sent at least once every two seconds throughout the stream.
  • A max bit rate of 4 Mbps is recommended. Going above this maximum is possible but will make live streams highly unstable.
  • A single resolution throughout the video. Changing resolution midstream has a negative impact on broadcasts.
  • Titles with less than 255 characters otherwise the stream will fail.
  • The Live API accepts H264 encoded video and AAC encoded audio only.

Video Length

  • 4 hour maximum length for live stream.
  • 4 hour maximum length for preview streams (either through Live dialog or publisher tools). After 240 minutes, a new stream key must be generated.
  • RTMP stream URLs will expire 24 hours after they are created.

Advanced Audio Settings

  • Audio Bitrate: 128 Kbps mono
  • Audio Codec: AAC
  • Audio Sample Rate: 48 KHz

Advanced Video Settings

  • Bitrate Encoding: CBR
  • Frame Types: Progressive Scan
  • Pixel Aspect Ratio: Square
  • Video Codec: H264

Recommendations

  • Although you can stream a previously recorded video to a LiveVideo object, we highly recommend that you only show live content during live videos. This ensures that live content remains live.
  • Broadcast for longer periods of time to reach more people. The longer you broadcast, the more likely people are to discover and share your video with their friends on Facebook. We recommend that you go live for at least 10 minutes, though you can stay live for up to 4 hours.
  • Tag your location! Adding your location to a live video increases the chance that you'll appear on the Facebook Live Map!
  • For optimal security of your streams, we recommend using the RTMPS stream URL and key. This will encrypt your live stream.
  • Set up a wired internet connection to ensure stability. Wireless internet connections will work but may drop streams due to poor network connectivity.
  • If possible, we encourage the use of hardware encoders in lieu of online encoders that run through your machine or computer. This will help with stability and ensure that frames are pushed successfully to the Facebook Live endpoint.

Copyright Handling

Our Rights Manager tools helps you easily upload and maintain a reference library of video content to monitor and protect, including live video streams. Our Rights Management API enables publishers to claim copyright ownership for videos and manage copyright matching rules.

Additionally, your live video may be stopped if there is a copyright infringement detected. This can be prevented by ensuring all rights have been cleared for content that will be used in Live streams and licensors have whitelist their pages. Content management technology is in place that will potentially flag, block, and remove content that is not cleared (such as a video containing unlicensed background music).

Branded Content

Branded Content is any content that features a third-party product, brand, or sponsor ("marketer"). Verified pages (pages with a blue checkmark) can share branded content through live videos. For information about incorporating branded content within a live video, please see our documentation on creating branded content for Live Video.

Error Codes

Error messages will be sent via RTMP then will persist through to the Graph API. You can use the broadcast/video ID and query for the errors in the Graph Explorer tool via a GET request. Errors returned will contain the error code, description, and a timestamp.

error_subcodeError SummaryDescription
COPYRIGHT__LIVE_COPYRIGHT_VIOLATION

Live Copyright Violation

Your live video has been stopped because it may contain audio or visual content that belongs to a different Page.

VIDEO__CREATE_FAILED

Upload Problem

There was a problem and your video was not uploaded. Please try again.

LIVE_VIDEO__DELETE_FAILED

Live Video Not Deleted

There was a problem and we were not able to delete your live video. Please try again.

LIVE_VIDEO__EDIT_API_NOT_ALLOWED

Editing Via Video API Is Not Allowed While Live

Editing a live video using the Video Edit API is not allowed. Use the live video ID.

LIVE_VIDEO__LIVE_STREAM_ERROR

Generic Stream

There was an error during the stream

LIVE_VIDEO__NOT_EXIST

Live Video Does Not Exist

The live video you are trying to access does not exist in the system any more.

LIVE_VIDEO__PRIVACY_REQUIRED

Privacy Setting Required

You need to set a privacy before going live.