NAME

Imgur::API::Model::Album

DESCRIPTION

This model represents the data for albums

FIELDS

id string

The ID for the album

title string

The title of the album in the gallery

description string

The description of the album in the gallery

datetime integer

Time inserted into the gallery, epoch time

cover string

The ID of the album cover image

cover_width integer

The width, in pixels, of the album cover image

cover_height integer

The height, in pixels, of the album cover image

account_url string

The account username or null if it's anonymous.

account_id int

The account ID or null if it's anonymous.

privacy string

The privacy level of the album, you can only view public if not logged in as album owner

layout string

The view layout of the album.

views integer

The number of album views

link string

The URL link to the album

favorite boolean

Indicates if the current user favorited the image. Defaults to false if not signed in.

nsfw boolean

Indicates if the image has been marked as nsfw or not. Defaults to null if information is not available.

section string

If the image has been categorized by our backend then this will contain the section the image belongs in. (funny, cats, adviceanimals, wtf, etc)

order integer

Order number of the album on the user's album page (defaults to 0 if their albums haven't been reordered)

deletehash string

OPTIONAL, the deletehash, if you're logged in as the album owner

images_count integer

The total number of images in the album

images Array of Images

An array of all the images in the album (only available when requesting the direct album)

in_gallery boolean

True if the image has been submitted to the gallery, false if otherwise.

EXAMPLE

{
  "status" : 200,
  "data" : {
     "layout" : "blog",
     "title" : "Imgur Office",
     "privacy" : "public",
     "datetime" : 1357856292,
     "link" : "http://alanbox.imgur.com/a/lDRB2",
     "views" : 13780,
     "cover" : "24nLu",
     "account_url" : "Alan",
     "images" : [
        {
           "bandwidth" : 116174397976,
           "description" : null,
           "id" : "24nLu",
           "title" : null,
           "size" : 855658,
           "datetime" : 1357856352,
           "type" : "image/jpeg",
           "link" : "http://i.imgur.com/24nLu.jpg",
           "width" : 2592,
           "height" : 1944,
           "views" : 135772,
           "animated" : false
        },
        {
           "bandwidth" : 124571044763,
           "description" : null,
           "id" : "Ziz25",
           "height" : 1944,
           "width" : 2592,
           "views" : 135493,
           "animated" : false,
           "title" : null,
           "size" : 919391,
           "datetime" : 1357856394,
           "type" : "image/jpeg",
           "link" : "http://i.imgur.com/Ziz25.jpg"
        },
        {
           "height" : 1944,
           "width" : 2592,
           "views" : 135063,
           "animated" : false,
           "title" : null,
           "size" : 655028,
           "datetime" : 1357856385,
           "type" : "image/jpeg",
           "link" : "http://i.imgur.com/9tzW6.jpg",
           "bandwidth" : 88470046764,
           "id" : "9tzW6",
           "description" : null
        },
        {
           "title" : null,
           "size" : 812738,
           "type" : "image/jpeg",
           "datetime" : 1357856378,
           "link" : "http://i.imgur.com/dFg5u.jpg",
           "height" : 1944,
           "width" : 2592,
           "views" : 134704,
           "animated" : false,
           "bandwidth" : 109479059552,
           "description" : null,
           "id" : "dFg5u"
        },
        {
           "type" : "image/jpeg",
           "datetime" : 1357856338,
           "link" : "http://i.imgur.com/oknLx.jpg",
           "title" : null,
           "size" : 717324,
           "animated" : false,
           "width" : 1749,
           "height" : 2332,
           "views" : 32938,
           "bandwidth" : 23627217912,
           "id" : "oknLx",
           "description" : null
        },
        {
           "bandwidth" : 46683752652,
           "description" : null,
           "id" : "OL6tC",
           "height" : 1944,
           "width" : 2592,
           "views" : 32346,
           "animated" : false,
           "title" : null,
           "size" : 1443262,
           "type" : "image/jpeg",
           "datetime" : 1357856321,
           "link" : "http://i.imgur.com/OL6tC.jpg"
        },
        {
           "id" : "cJ9cm",
           "description" : null,
           "bandwidth" : 17337319958,
           "size" : 544702,
           "title" : null,
           "link" : "http://i.imgur.com/cJ9cm.jpg",
           "type" : "image/jpeg",
           "datetime" : 1357856330,
           "views" : 31829,
           "height" : 1944,
           "width" : 2592,
           "animated" : false
        },
        {
           "type" : "image/jpeg",
           "datetime" : 1357856369,
           "link" : "http://i.imgur.com/7BtPN.jpg",
           "title" : null,
           "size" : 844863,
           "animated" : false,
           "height" : 1944,
           "width" : 2592,
           "views" : 31257,
           "bandwidth" : 26407882791,
           "description" : null,
           "id" : "7BtPN"
        },
        {
           "animated" : false,
           "views" : 30945,
           "height" : 1944,
           "width" : 2592,
           "link" : "http://i.imgur.com/42ib8.jpg",
           "datetime" : 1357856424,
           "type" : "image/jpeg",
           "size" : 905073,
           "title" : null,
           "id" : "42ib8",
           "description" : null,
           "bandwidth" : 28007483985
        },
        {
           "id" : "BbwIx",
           "description" : null,
           "bandwidth" : 19943268191,
           "size" : 662413,
           "title" : null,
           "link" : "http://i.imgur.com/BbwIx.jpg",
           "datetime" : 1357856360,
           "type" : "image/jpeg",
           "views" : 30107,
           "width" : 1749,
           "height" : 2332,
           "animated" : false
        },
        {
           "datetime" : 1357856406,
           "type" : "image/jpeg",
           "link" : "http://i.imgur.com/x7b91.jpg",
           "title" : null,
           "size" : 618567,
           "animated" : false,
           "height" : 2592,
           "width" : 1944,
           "views" : 29259,
           "bandwidth" : 18098651853,
           "description" : null,
           "id" : "x7b91"
        }
     ],
     "description" : null,
     "id" : "lDRB2",
     "account_id" : 4,
     "images_count" : 11
  },
  "success" : true
}

SEE ALSO

http://api.imgur.com/models/album