Graph API Version

Album

Represents an Album.

Reading

GET /{album-id}

Get fields and edges on an Album.

Requirements

Requirements depend on the type of node that the Album is on.

Requirement	User nodes	Page nodes	Group nodes
Access Tokens	Any	Any	User
Features	None	To get public Page content of Pages you can not perform a task on, you will need `Page Public Content Access`	None
Permissions	`user_photos`	Unpublished Pages: You must be able to perform the `CREATE` task on the Page `pages_read_engagement` Published Pages: `pages_read_engagement`	None
Group Roles	Not applicable	Not applicable	Admin

Request Syntax

Graph API Explorer

GET /v21.0/{album-id} 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(
    '/{album-id}',
    '{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(
    "/{album-id}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

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

/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{album-id}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Fields

Name	Description	Type
`id`	The album ID.	`string`
`can_upload`	Whether the viewer can upload photos to this album.	`boolean`
`count`	The approximate number of photos in the album. This is not necessarily an exact count	`int`
`cover_photo`	The ID of the album's cover photo.	`Photo`
`created_time`	The time the album was initially created.	`datetime`
`description`	The description of the album.	`string`
`event`	The event associated with this album.	`Event`
`from`	The current user, if the current user created the album.	`User`
`link`	A link to this album on Facebook.	`string`
`location`	The textual location of the album.	`string`
`name`	The title of the album.	`string`
`place`	The place associated with this album.	`Page`
`privacy`	The privacy settings for the album.	`string`
`type`	The type of the album.	`enum{app, cover, profile, mobile, wall, normal, album}`
`updated_time`	The last time the album was updated.	`datetime`

Edges

You can request the following edges as path parameters or by using the fields query string parameter.

Edge	Description
`photos`	Represents a collection of Photos on an Album.

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.