Fresh 2026

Audience Targeting

Include and exclude specific audiences from viewing your Live Video.

Before You Start

For live videos on a Page, you will need:

• A Page access token requested by a person who can perform the CREATE_CONTENT task on the Page
• The pages_read_user_content permission
• The pages_manage_engagement permission
• The pages_show_list permission
• The publish_video permission

Node

• LiveVideo

Create a Target Audience

To set a target audience, send a POST to the /id request where id is the LiveVideo ID and set the targeting parameter to an object with a comma separated list of audience parameters.

When testing an API call, you can include the access_token parameter set to your access token. However, when making secure calls from your app, use the access token class.

curl -i -X POST \
  "https://graph.facebook.com/v25.0/<LIVE_VIDEO_ID>
    ?targeting={
      age_min:17,
      geo_locations:{
        countries:["US","CA","MX"]
      }
    }"

On success your app receives a JSON response with a list of audience parameters that have been set.

Sample Response

{
  "targeting": {
    "age_max": 65,
    "age_min": 17,
    "geo_locations": {
      "countries": [\
        "US",\
        "CA",\
        "MX"\
      ]
    }
  },
  "id": "<LIVE_VIDEO_ID>"
}

Get Target Audience Information

To get a list of audience target information, send a GET request to the /LIVE_VIDEO_ID endpoint with the field parameter set to targeting.

curl -i -X GET \
  "https://graph.facebook.com/v25.0/<LIVE_VIDEO_ID>
    ?fields=targeting"

On success your app receives a JSON response with a list of audience parameters that have been set.

Sample Response

{
  "targeting": {
    "age_max": 65,
    "age_min": 17,
    "geo_locations": {
      "countries": [\
        "US"\
        "CA",\
        "MX"\
      ]
    }
  },
  "id": "<LIVE_VIDEO_ID>"
}