Live Video API

The Live Video API enables video encoders, cameras, web, and desktop applications to stream live video directly to Facebook user profiles, pages, and groups. As long as your app can produce a live RTMPS stream, you can stream to Facebook using the Live Video API.

Requirements

To use this API, your app must undergo App Review for the following features and permissions.

Features

Permissions

Most endpoints require a mix of the following permissions. To determine which permissions you need, refer to the reference documents for each of the endpoints your app uses.

Publishing on a User

Publishing on a Page

Publishing on a Group

RTMPS

Live Video streams on Users, Events, and Groups must be encrypted using the RTMPS data transfer protocol. When starting a live stream, the API will return an RTMPS secure stream URL which you must use when streaming to our servers.

Live Video streams on Pages and Workplace can use the non-encrypted standard RTMP protocol until November 1st, 2019, after which RTMP will no longer be supported. When starting a live stream, the API response will include an RTMP stream URL which can be used for non-encrypted streaming to our servers. Note that if you are using RTMP and using a persistent stream key, you should reset your persistent key and update any devices that use them or your streams will fail.

As of May 1st, 2019, the following software and hardware providers support RTMPS:

  • Elemental
  • BeLive.tv
  • DJI
  • EasyLive
  • Epiphan
  • Haivision
  • Grabyo
  • LiveU
  • LiveStream
  • Mevo
  • OBS
  • Switcher Studio
  • Telescope
  • Telestream
  • Teradek
  • Wowza
  • XSplit
  • FFmpeg

Next Steps

Follow our Getting Started Guide to see how you can stream to your User profile using your own app or the Graph API explorer.