Video API

Get Facebook Videos using the Facebook Video API

This document shows you how to get Video data, such as IDs, description, and updated times, for videos published on Facebook Pages or User Feeds.

Get Page Videos

Before You Start

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

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

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/&lt;PAGE_ID>/videos?access_token=&lt;PAGE_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:

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.

See Also