FacebookLiveAPI API Documentation

Stream, search and manage live video on Facebook.

Learn more about this API

POSTcreateLiveVideo

POSTdeleteLiveVideo

POSTgetLiveVideo

POSTgetLiveVideoComments

POSTgetLiveVideoErrors

POSTgetLiveVideoLikes

POSTgetLiveVideoReactions

POSTupdateLiveVideo

Allows to create live video.

Header Parameters

X-RapidAPI-HostSTRING

REQUIRED

X-RapidAPI-KeySTRING

REQUIRED

Required Parameters

edgeSTRING

REQUIREDvalid liveVideoId.

accessTokenCREDENTIALS

REQUIREDYour accessToken obtained from Facebook.

Optional Parameters

statusSELECT

OPTIONALChoose between UNPUBLISHED or LIVE_NOW.

plannedStartTimeSTRING

OPTIONALUnix timestamp when the broadcaster plans to go live.

descriptionSTRING

OPTIONALThe description of the live video.

publishedSTRING

OPTIONALSet this to false to preview the stream before going live. Deprecated. Prefer setting the status instead.

titleSTRING

OPTIONALThe title of the live video.

streamTypeSTRING

OPTIONALThe type of stream. Default value: REGULAR. Use AMBIENT for continuous broadcasts that last days or weeks (like panda cams). Ambient broadcasts do not generate VOD or notifications.

contentTagsSTRING

OPTIONALTags that describe the contents of the video. Use search endpoint with type=adinterest to get possible IDs.

saveVodSTRING

OPTIONALWhether or not the video data should be saved for later consumption in VOD format. Default is true, except for certain broadcasts types (e.g. AMBIENT)

privacySTRING

OPTIONALPrivacy for this live video.

stopOnDeleteStreamSTRING

OPTIONALDefault value: true. Set this to true if stream should be stopped when deleteStream RTMP command received.

isAudioOnlySTRING

OPTIONALFlag to indicate that the broadcast is audio-only andhas no video stream.

targetingJSON

OPTIONALObject and looks like only for page_id edge that limits the audience for this content. Anyone not in these demographics will not be able to view this content.