Social API — Facebook video post


This method will return data about a Facebook video post.

Definition

GET http://social.api.condenet.co.uk/facebook/graph/video/


Query Parameters

url: required. The URL of a facebook video, eg,

https://www.facebook.com/BritishGQ/videos/10154047845941051/

Example request

$ curl http://social.api.condenet.co.uk/facebook/graph/video/?url=https://www.facebook.com/BritishGQ/videos/10154047845941051/

Example response

Please note this response is truncated
{
  "data": {
    "author_name": "British GQ",
    "author_url": "https://www.facebook.com/BritishGQ/",
    "height": 281,
    "html": "...",
    "provider_name": "Facebook",
    "provider_url": "https://www.facebook.com",
    "success": true,
    "type": "video",
    "url": "https://www.facebook.com/BritishGQ/videos/10154047845941051/",
    "version": "1.0",
    "width": 500
  }
}

Error handling

If the given url is not recognised by Facebook, a 500 response will be returned.

Example error response

{
  "error": "Failed to find facebook video/post"
}

If the url query string parameter is not supplied, a 400 response will be returned

Example error response

{
  "error": "Invalid url argument"
}