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.

RequirementUser nodesPage nodesGroup 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:

Published Pages:

None

Group Roles

Not applicable

Not applicable

Admin

Request Syntax

Graph API Explorer
GET /v8.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();
// For more complex open graph stories, use `FBSDKShareAPI`
// with `FBSDKShareOpenGraphContent`
/* 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.