Get Videos

This document explains how to get Videos on Pages, Groups, and Users.

Get Group Videos

Before You Start

To get videos of a User’s group, you will need:

A User access token requested by a person who manages the group
The publish_to_groups permission

To get videos of a Page’s group, you will need:

A Page access token requested by the Page that admins the group
The Groups API feature

Send a GET request to /{group-id}/videos endpoint:

curl -i -X GET "https://graph.facebook.com/{group-id}/videos?access_token={access-token}"

On success, your app receives the following:

{
  "data": [
    {
      "updated_time": "2020-05-18T18:51:15+0000",
      "id": "{video-id-1}"
    },
    {
      "description": "Sunshine",
      "updated_time": "2020-05-18T18:35:09+0000",
      "id": "{video-id-2}"
    }
    ...
  ],
  "paging": {
    "cursors": {
      "before": "...",
      "after": "..."
    }
  }
}

Get Page Videos

Before You Start

For Pages on which you are able to perform the MANAGE task, you will need:

A Page access token requested by a person who can perform the MANAGE task on the Page
The pages_read_engagement permission

For public Pages, which you are not able to perform the MANAGE task, you will need:

A User access token
The Page Public Content Access

Send a GET request to the /{page-id}/videos endpoint to get a list of all videos of a Page.

curl -i -X GET "https://graph.facebook.com/{page-id}/videos?access_token={access-token}"

On success, your app receives the following response:

{
  "data": [
    {
      "description": "Clouds",
      "updated_time": "2019-09-25T17:18:30+0000",
      "id": "2153206464921154"
    },
    {
      "updated_time": "2020-03-26T23:45:11+0000",
      "id": "2232477747039197"
    },
    ...
  ],
  "paging": {
    "cursors": {
      "before": "MjE1MzIwNjQ2NDkyMTE1NAZDZD",
      "after": "MTQwOTU5MTg4NTc2MzM0MwZDZD"
    }
  }
}

Get User Videos

Before You Start

You will need:

A User access token requested by the User who owns the video
The user_videos permission

Send a GET request to the /{user-id}/videos?type=uploaded to get all videos a person has uploaded or /{user-id}/videos?type=tagged to get all videos a person has been tagged in.

curl -i -X GET "https://graph.facebook.com/{user-id}/videos
  ?type=uploaded
  &access_token={user-access-token}"

On success, your app receives the following response:

{
  "data": [
    {
      "description": "Rain",
      "updated_time": "2020-05-18T20:07:47+0000",
      "id": "{video-id-1}"
    },
    {
      "updated_time": "2020-05-20T12:26:19+0000",
      "id": "{video-id-2}"
    },
    ...
  ]
  "paging": {
    "cursors": {
      "before": "...",
      "after": "..."
    }
  }
}

Limitations

By default, a GET request without a type specified will return videos a person was tagged in.
If no description is returned, the video post contained no accompanying text.

Get Videos

Get Group Videos

Before You Start

Get Page Videos

Before You Start

Get User Videos

Before You Start

Limitations

See Also