URL `/?id={url}`

Represents an external URL as it relates to the Facebook social graph - shares and comments from the URL on Facebook, and any Open Graph objects associated with the URL.

This endpoint replaces engagement counts found on the now retired Facebook REST APIs. However, there are some counts that were in the REST API that are not available in this API. Please see below for the list of supported counts.

Reading

Graph API Explorer

GET /v3.1/?id=http%3A%2F%2Fwww.imdb.com%2Ftitle%2Ftt2015381%2F HTTP/1.1
Host: graph.facebook.com

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */

/* make the API call */
FB.api(
    "/",
    {
        "id": "http:\/\/www.imdb.com\/title\/tt2015381\/"
    },
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

Bundle params = new Bundle();
params.putString("id", "http://www.imdb.com/title/tt2015381/");
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/",
    params,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

// For more complex open graph stories, use `FBSDKShareAPI`
// with `FBSDKShareOpenGraphContent`
NSDictionary *params = @{
  @"id": @"http://www.imdb.com/title/tt2015381/",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Permissions

Any access token can be used to make this request.

Fields

Property Name	Description	Type
`app_links`	AppLinks data associated with this URL, if available.	`AppLinks`
`id`	The URL itself.	`string`
`og_object`	The Open Graph object that is canonically associated with this URL.	`OGObject`
`id`	ID of object.	`string`
`description`	The description of the object, if available.	`string`
`title`	The title of the object, if available.	`string`
`type`	The object type.	`og:type`
`updated_time`	When the object was last updated.	`datetime`
`share`	An object that supplies information about the URL being shared on Facebook.	`object`
`comment_count`	Number that is shown in the comments plugin associated with the URL. This number does not include comments that are made on posts on Facebook	`int`
`share_count`	This number is an aggregation of shares, likes, and comments for the URL. This number is approximate	`int`

Sample Request of Engagement Counts

curl -i -X GET \
  "https://graph.facebook.com/vX.X/?id=http%3A%2F%2Fwww.imdb.com%2Ftitle%2Ftt2015381%2F&fields=engagement&access_token=user-access-token"

Sample Response

{
  "engagement": {
    "reaction_count": 45315,
    "comment_count": 31742,
    "share_count": 25671,
    "comment_plugin_count": 3
  },
  "id": "http://www.imdb.com/title/tt2015381/"
}

Publishing

You cannot publish this info via the Graph API.

Deleting

You cannot delete this info via the Graph API.

Updating

Make a Graph API call using this endpoint, replacing "{your_url}" with the URL for the link you are updating. The URL must be encoded so that it doesn't interfere with the scrape parameter.

POST "https://graph.facebook.com/vX.X/?id={your_url}&scrape=true"

URL /?id={url}