Rights Manager API

The Rights Manager API enables publishers to claim copyright ownership for videos and manage copyright matching rules with two new endpoints: the video_copyright_rule endpoint and video_copyright endpoint.

Permissions

To use this API, you'll need to apply for access to the Rights Manager tool. You can read more and learn about Rights Manager in rightsmanager.fb.com.

Copyrighting Video

The Rights Manager API can only be applied to videos on pages. All pages need to go through the enrollment process in order to be eligible to use the API.
Before you can copyright video you should create video content on a Facebook Page. This can be done through the Video Upload API or Live Video API.

For Videos, the steps are:

  1. Upload a video to Facebook and obtain video id.
  2. Use Rights Manager API to copyright the video.

For Live Videos, the steps are:

  1. Create a live_video object and obtain live video id.
  2. Use Rights Manager API to copyright the live video.
  3. Start streaming using your streaming software.

For Media Fingerprints, the steps are:

  1. Generate media fingerprint from media file.
  2. Create a media_fingerprint object and obtain media fingerprint id.
  3. Use Rights Manager API to copyright the media fingerprint.

Reference Only

If the video should be used only as a reference video, and not for consumption and distribution on Facebook, the video should be uploaded using the 'reference_only' param, and the Rights Manager API needs to be called using the is_reference_video param. When streaming, just make sure you call Rights Manager with 'is_reference_video' before starting to stream. The video or live video will not appear in your Video Library, and will only be visible to the Admin, in the Reference Files section of the Rights Manager tool.

Understanding the video_copyright_rule and video_copyright Endpoints

  • video_copyright_rule endpoint: This endpoint allows you to create a copyright rule. For example, you can determine under what kind of condition a copyright report should be triggered and what kind of action should be taken. This endpoint is optional, you may choose not to have any copyright rules.

  • video_copyright endpoint: You can use this endpoint to copyright a specific video. You can also specify copyright ownership and apply a copyright rule here.

The video_copyright_rule Endpoint

The video_copyright_rule endpoint allows you to create copyright rules that determine which actions to take on a video that matches these rules. For example, you as a rights owner can create a copyright rule that allows usage of your video for less than 3 minutes.

There are three types of conditions:

  • MONITORING_TYPE: Determines if the video, audio, or both match
  • OVERLAP_DURATION: Determines how long the match occurs (greater or less than 2 or 3 minutes for example)
  • GEO: Determines if the video is available in a certain location. For example, if a video can be viewed in the UK, and the geo condition is 'UK and US', then the video meets the condition.

There is one available action type:

  • ALLOW: When you select this action type, you are allowing all videos that match this copyright rule to be ignored. The matches will be routed to a separate folder instead of your 'New Matches' folder in the Rights Manager tool, where you can still view them, but you won't have to approve them manually.

If you do not supply any copyright rules, all matches to your reference files will be surfaced in your Rights Manager's New Matches dashboard.

Creating a Copyright Rule

You can create a copyright rule by making a POST/{pageid}/video_copyright_rule request.

curl \
-X POST \
'https://graph.facebook.com/v2.6/405152342992687/video_copyright_rules' \
 -F 'access_token=XXXXXXXX' \
 -F 'name="testrule"' \
 -F 'condition_groups=[{action:"ALLOW",conditions:[{type:"MONITORING_TYPE",operator:"IS",value:"VIDEO_ONLY"},{type:"OVERLAP_DURATION",operator:"LESS_THAN",value:120000},{type:"GEO",operator:"IN_SET",value:["AR","AU"]}]}]'

Reading a Copyright Rule

Issue a GET /video_copyright_rule_id request to get more information about the copyright rule.

** Note in this example that 576407315867188 is the copyright rule ID.

curl \
-X GET \
'https://graph.facebook.com/v2.6/576407315867188?&access_token=XXXXXXXX' \

Deleting a Copyright Rule

You can delete a live video by making a DELETE /video_copyright_rule_id request.

The video_copyright Endpoint

The video_copyright endpoint allows you to specify which video you want to copyright. From this endpoint, you can whitelist other pages or users to use the reference video. For example, if you have 3 pages and want to copyright a certain video to be able to play on all of your pages, you can specify those pages in the whitelist.

Creating a video_copyright Endpoint

You can make a POST request to the video_copyrights edge from the following paths: /{page_id}/video_copyrights

** Note in this example that 576425449198708 is the video ID representing the video to be copyrighted.

curl \
-X POST \
'https://graph.facebook.com/v2.6/405152342992687/video_copyrights' \
-F  'access_token=XXXXXXXX' \
-F  'copyright_content_id=576425449198708' \
-F  'is_reference_video=true' \
-F  'monitoring_type=VIDEO_ONLY' \
-F  'rule_id=576407315867188' \
-F  'whitelisted_ids=[139577256378818]' \
-F  'ownership_countries=[“us”,”ca”]' \
Return values: Video copyright id.
{"id":"576425925865327"}

For any given video, you can query the 'copyright' field to obtain more information about the video_copyright node.

curl \
-X GET \
'https://graph.facebook.com/v2.6/576407315867188?fields=copyright&access_token=XXXXXXXX' \

Update, Read, and Delete capabilities are also available for the video_copyright endpoint. For more information, please refer to the video copyright endpoint documentation.