Graph API Version

/{page-id}.context/friends_who_like

A list of friends who also like this Facebook page.

Reading

GET /v2.10/{page-id}?fields=context.fields%28friends_who_like%29 HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
$request = new FacebookRequest(
  $session,
  'GET',
  '/{page-id}',
  array (
    'fields' => 'context.fields(friends_who_like)',
  )
);
$response = $request->execute();
$graphObject = $response->getGraphObject();
/* handle the result */
/* make the API call */
FB.api(
    "/{page-id}",
    {
        "fields": "context.fields(friends_who_like)"
    },
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
Bundle params = new Bundle();
params.putString("fields", "context.fields(friends_who_like)");
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{page-id}",
    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 = @{
  @"fields": @"context.fields(friends_who_like)",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{page-id}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Permissions

  • A valid user access token with the user_friends permission is required to return any friends of that user.
  • Only friends who also use the requesting app will be returned.

Fields

An array of User objects each representing a friend, and the following:

NameDescriptionType

summary

Some metadata which summarizes the social context.

object

total_count

The full count of friends who like this page, including those not using the app.

integer

social_sentence

A natural text string that takes the form:

{total_count} of your friends like this.

string

Publishing

You can't publish using this edge.

Deleting

You can't delete using this edge.

Updating

You can't update using this edge.