User Picture

Graph API Version

A Picture for a Facebook User.

Reading

The person's profile picture

By default this edge will return a 302 redirect to the picture image. To get access to the data about the picture, please include redirect=false in your query.

Graph API Explorer

GET /v2.10/{user-id}/picture HTTP/1.1
Host: graph.facebook.com

/* PHP SDK v5.0.0 */
/* make the API call */
$request = new FacebookRequest(
  $session,
  'GET',
  '/{user-id}/picture'
);
$response = $request->execute();
$graphObject = $response->getGraphObject();
/* handle the result */

/* make the API call */
FB.api(
    "/{user-id}/picture",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{user-id}/picture",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

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

Permissions

Developers usually request these permissions for this endpoint:

Marketing Apps

No data

Page management Apps

No data

Other Apps

Permissions are not usually requested.

Parameters

Name	Description
`height` integer	The height of this picture in pixels.
`redirect` boolean	Default value: `true` By default the picture edge will return a picture instead of a JSON response. If you want the picture edge to return JSON that describes the image set `redirect=0` when you make the request.
`type` enum{small, normal, album, large, square}	The size of this picture. It can be one of the following values: small, normal, large, square.
`width` integer	The width of this picture in pixels.

Fields

Reading from this edge will return a JSON formatted result:

{
    "data": "ProfilePictureSource",
    "paging": {}
}

`data`

A single ProfilePictureSource node.

`paging`

For more details about pagination, see the Graph API guide.

Validation Rules

Error	Description
100	Invalid parameter
200	Permissions error

Creating

You can't perform this operation on this endpoint.

Updating

You can't perform this operation on this endpoint.

Deleting

You can't perform this operation on this endpoint.