Reference

Specifications

Live video data streamed to a broadcast’s ingest stream URL must meet the following specifications. Videos must include both audio and video data and cannot exceed 8 hours in duration. Do not switch settings mid-broadcast.

Video Settings

Resolution — 1280x720
Frame Rate — 30 FPS
Frame Type — Progressive Scan
Keyframe Interval — 2 seconds
Pixel Aspect Ratio — Square
Video Bitrate — 4 Mbps maximum for 720p, 9Mbps for 1080p
Video Codec — H.264 Main Profile (MP 77), H.264 High Profile (HiP 100), CBR

Audio Settings

Audio Codec — AAC
Sample Rate — 48kHz
Audio Bitrate — 256kbps
Channel Layout — Stereo

Endpoints

LiveVideo

Endpoint	Description
`DELETE /{live_video_id}`	Delete a LiveVideo.
`GET /{event-id}/live_videos`	Get a collection of LiveVideos on an Event.
`GET /{group-id}/live_videos`	Get a collection of LiveVideos on a Group.
`GET /{live-video-id}`	Get fields and edges on a LiveVideo.
`GET /{live-video-id}/comments`	Get a collection of Comments on a LiveVideo.
`GET /{live-video-id}/crosspost_shared_pages`	Get a collection of Pages able to share a LiveVideo.
`GET /{live-video-id}/likes`	Get a collection of Profiles that liked a LiveVideo.
`GET /{live-video-id}/polls`	Get a collection of VideoPolls on a LiveVideo.
`GET /{live-video-id}/reactions`	Get a collection of Profiles that have reacted to a LiveVideo.
`GET /{page-id}/live_videos`	Get a collection of LiveVideos on a Page.
`GET /{user-id}/live_videos`	Get a collection of LiveVideos on a User.
`POST /{event-id}/live_videos`	Create a LiveVideo on an Event.
`POST /{group-id}/live_videos`	Create a LiveVideo on a Group.
`POST /{live_video_id}`	Update fields on a LiveVideo.
`POST /{live_video_id}/input_streams`	Create a LiveVideoInputStream on a LiveVideo.
`POST /{live_video_id}/polls`	Create a VideoPoll on a LiveVideo.
`POST /{page-id}/live_videos`	Create a LiveVideo on a Page.
`POST /{user-id}/live_videos`	Create a LiveVideo on a User.

LiveVideoInputStream

Endpoint	Description
`GET /{live-video-input-stream-id}`	Get fields and edges on a LiveVideoInputStream.
`POST /{live_video_id}/input_streams`	Create a LiveVideoInputStream on a LiveVideo.

Polls

Endpoint	Description
`GET /{live-video-id}/polls`	Get a collection of VideoPolls on a LiveVideo.
`GET /{video-poll-id}`	Get fields and edges on a VideoPoll.
`POST /{live_video_id}/polls`	Create a VideoPoll on a LiveVideo.
`POST /{video_poll_id}`	Update fields on a VideoPoll.

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_subcode	Error Summary	Description
`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.