The profile picture of a Facebook Page.
Get the profile picture of a Facebook Page.
MANAGE
task on the Page.GET /v21.0/{page-id}/picture?redirect=0 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(
'/{page-id}/picture?redirect=0',
'{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(
"/{page-id}/picture",
{
"redirect": "0"
},
function (response) {
if (response && !response.error) {
/* handle the result */
}
}
);
Bundle params = new Bundle();
params.putString("redirect", "0");
/* make the API call */
new GraphRequest(
AccessToken.getCurrentAccessToken(),
"/{page-id}/picture",
params,
HttpMethod.GET,
new GraphRequest.Callback() {
public void onCompleted(GraphResponse response) {
/* handle the result */
}
}
).executeAsync();
NSDictionary *params = @{
@"redirect": @"0",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
initWithGraphPath:@"/{page-id}/picture"
parameters:params
HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
id result,
NSError *error) {
// Handle the result
}];
curl -X GET -G \
-d 'redirect=0' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/{page-id}/picture
Parameter | 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 |
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. |
Reading from this edge will return a JSON formatted result:
{ "
data
": [], "paging
": {} }
data
paging
Error | Description |
---|---|
190 | Invalid OAuth 2.0 Access Token |
100 | Invalid parameter |
200 | Permissions error |
368 | The action attempted has been deemed abusive or is otherwise disallowed |
459 | The session is invalid because the user has been checkpointed |
picture
edge from the following paths: MANAGE
task on the Page.Parameter | Description |
---|---|
android_key_hash string | Android key hash for the proxied app ID. |
burn_media_effect boolean | burn_media_effect |
caption UTF-8 string | The caption for a profile pic Supports Emoji |
composer_session_id string | Composer session ID |
frame_entrypoint string | frame_entrypoint |
has_umg boolean | Whether or not the picture uploaded has edits made in the unified media gallery |
height int64 | Height for crop |
ios_bundle_id string | iOS bundle ID for the proxied app ID. |
media_effect_ids list<int> | Set of Media Effect IDs that were used on this pic |
media_effect_source_object_id int | The FBID of the media from which the effects were sourced. |
msqrd_mask_id string | MSQRD mask ID that was used to create this pic Deprecated |
photo numeric string | ID of the photo to use as the profile pic |
picture URL | URL of the picture to upload |
profile_pic_method string | Method of the profile pic change for logging |
profile_pic_source string | Source of the profile pic change for logging |
proxied_app_id int | ID of the proxied app that performed this action |
qn string | Waterfall logger session ID |
reuse boolean | Whether to reuse an existing profile pic |
scaled_crop_rect Object | Dictionary with fractional (scaled) keys x/y/width/height for crop |
set_profile_photo_shield string | Whether to set Women in Emerging Markets Profile Photo Safety Shield on or off |
sticker_id int | Sticker ID for profile pics with sticker overlays |
sticker_source_object_id int | The FBID of the source media |
suppress_stories boolean | suppress_stories |
width int64 | Width for crop |
x int64 | Top-left x-coordinate for crop |
y int64 | Top-left y-coordinate for crop |
success
: bool, Error | Description |
---|---|
368 | The action attempted has been deemed abusive or is otherwise disallowed |
332 | The image you tried to upload is too small. Please try again with a larger image. |
190 | Invalid OAuth 2.0 Access Token |
100 | Invalid parameter |
240 | Desktop applications cannot call this function for other users |
200 | Permissions error |
324 | Missing or invalid image file |