Response [200 Ok]

Uri /api/v2/album/CNm7wz?_responseLevel=Default
UriDescription Album by key
DocUri https://api.smugmug.com/api/v2/doc/reference/album.html
EndpointType Album
Locator Album
LocatorType Object

Album [1 of 1] - Tube150 in DigitalSLRPhoto
/api/v2/album/CNm7wz

Uri /api/v2/album/CNm7wz
UriDescription Album by key
ResponseLevel Public
AlbumKey CNm7wz
AllowDownloads true
CanBuy false
CanFavorite false
CanShare false
Description London Underground Photo Exhibition in the Malaysia edition of <a href="http://www.digitalslrphoto.com/" target="_blank"><i>Digital SLR Photography</i> magazine</a>, June 2013<br><a href="http://www.linyangchen.com/tube150">back to exhibition information</a>
EXIF false
External true
Filenames false
Geography false
HasDownloadPassword false
ImageCount 4
ImagesLastUpdated 2013-11-30T21:15:56+00:00
Keywords DigitalSLRPhoto; london underground exhibition; tube photography; tube150 exhibition; yangchen lin
LastUpdated 2013-11-30T21:14:47+00:00
Name Tube150 in DigitalSLRPhoto
NiceName Tube150mag
NodeID WDsRw
Packages false
PasswordHint empty string
Protected false
SecurityType None
SortDirection Ascending
SortMethod Position
Title Tube150 in DigitalSLRPhoto
UrlName Tube150mag
UrlPath /Tube150mag
WebUri https://www.linyangchen.com/Tube150mag

Uris

AlbumDownload
/api/v2/album/CNm7wz!download

Uri /api/v2/album/CNm7wz!download
UriDescription Download album
EndpointType AlbumDownload
Locator Download
LocatorType Objects

AlbumHighlightImage
/api/v2/album/CNm7wz!highlightimage

Uri /api/v2/album/CNm7wz!highlightimage
UriDescription Highlight image for album
EndpointType AlbumHighlightImage
Locator AlbumImage
LocatorType Object
AlbumImage [1 of 1]

AlbumImages
/api/v2/album/CNm7wz!images

Uri /api/v2/album/CNm7wz!images
UriDescription Images from album
EndpointType AlbumImages
Locator AlbumImage
LocatorType Objects

AlbumPopularMedia
/api/v2/album/CNm7wz!popularmedia

Uri /api/v2/album/CNm7wz!popularmedia
UriDescription Popular images from album
EndpointType AlbumPopularMedia
Locator AlbumImage
LocatorType Objects

AlbumPricelistExclusions
/api/v2/album/CNm7wz!pricelistexclusions

Uri /api/v2/album/CNm7wz!pricelistexclusions
UriDescription Pricelist information for an Album
EndpointType AlbumPricelistExclusions
Locator AlbumPricelistExclusions
LocatorType Object
AlbumPricelistExclusions [1 of 1]

AlbumPrices
/api/v2/album/CNm7wz!prices

Uri /api/v2/album/CNm7wz!prices
UriDescription Purchasable Skus
EndpointType AlbumPrices
Locator CatalogSkuPrice
LocatorType Objects

AlbumShareUris
/api/v2/album/CNm7wz!shareuris

Uri /api/v2/album/CNm7wz!shareuris
UriDescription URIs that are useful for sharing
EndpointType AlbumShareUris
Locator AlbumShareUris
LocatorType Object
AlbumShareUris [1 of 1]

Folder
/api/v2/folder/user/yangchen

Uri /api/v2/folder/user/yangchen
UriDescription A folder or legacy (sub)category by UrlPath
EndpointType Folder
Locator Folder
LocatorType Object
Folder [1 of 1]

HighlightImage
/api/v2/highlight/node/WDsRw

Uri /api/v2/highlight/node/WDsRw
UriDescription Highlight image for a folder, album, or page
EndpointType HighlightImage
Locator Image
LocatorType Object
Image [1 of 1]

Node
/api/v2/node/WDsRw

Uri /api/v2/node/WDsRw
UriDescription Node with the given id.
EndpointType Node
Locator Node
LocatorType Object
Node [1 of 1]

NodeCoverImage
/api/v2/node/WDsRw!cover

Uri /api/v2/node/WDsRw!cover
UriDescription Cover image for a folder, album, or page
EndpointType NodeCoverImage
Locator Image
LocatorType Object
Image [1 of 1]

ParentFolders
/api/v2/folder/user/yangchen!parents

Uri /api/v2/folder/user/yangchen!parents
UriDescription The sequence of parent folders, from the given folder to the root
EndpointType ParentFolders
Locator Folder
LocatorType Objects

User
/api/v2/user/yangchen

Uri /api/v2/user/yangchen
UriDescription User By Nickname
EndpointType User
Locator User
LocatorType Object
User [1 of 1]

Timing

Total

cycles 1
objects 0
time 0.0349

Config

{
    "expand_method": "ref",
    "shorturis": false
}

Options

Path

  • /api
  • /v2
  • /album
  • /

Notes

  • To sort images manually first set SortMethod to Position
  • When selecting SortMethod=Position, SortMethod is automatically set to Ascending
  • NiceName is deprecated; use UrlName instead
  • Title is deprecated; use Name instead
  • AlbumHighlightImage is deprecated, use HighlightImage instead

Methods

OPTIONS

Permissions
  • Read

GET

Permissions
  • Read

PATCH

Permissions
  • Modify

DELETE

Permissions
  • Modify

Output Fields

AlbumKey text
AlbumTemplateUri uri Specify default album presets by providing an AlbumTemplateUri.
AllowDownloads boolean
Backprinting text
BoutiquePackaging select
  • No
  • Yes
  • Inherit from User
CanBuy boolean
CanFavorite boolean
CanRank boolean
CanShare boolean Does the owner of this album want it to be shareable?
Clean boolean
Comments boolean
CommerceLightbox boolean
Date datetimeiso8601
Description text
DownloadPassword text
EXIF boolean
External Deprecated as of 2015-09-08 An old setting that no longer has any function
FamilyEdit boolean
FavoriteAlbumUrl fullurl
Filenames boolean
FriendEdit boolean
Geography boolean
HasDownloadPassword boolean
Header select
  • Custom
  • SmugMug
 Appearance
HideOwner boolean
HighlightAlbumImageUri uri
ImageCount integer
ImagesLastUpdated datetimeiso8601 The last time at which images were added, removed, or rearranged in this album
InterceptShipping select
  • No
  • Yes
  • Inherit from User
 Personal Delivery
Keywords text
LargestSize select
  • Medium
  • Large
  • XLarge
  • X2Large
  • X3Large
  • X4Large
  • X5Large
  • 4K
  • 5K
  • Original
LastUpdated datetimeiso8601
Name text
NiceName Deprecated as of 2014-11-20 Use UrlName instead
NodeID text
OriginalSizes integer
Packages boolean Are any packages available for album
PackagingBranding boolean
Password text
PasswordHint text
Printable boolean
PrintmarkUri uri
Privacy select
  • Public
  • Unlisted
  • Private
 "Private" is not supported on legacy accounts
ProofDays integer
ProofDigital boolean
Protected boolean Right-Click Protection
SecurityType select
  • None
  • Password
  • GrantAccess
Share boolean
Slideshow boolean
SmugSearchable select
  • No
  • Inherit from User
SortDirection select
  • Ascending
  • Descending
SortMethod select
  • Position
  • Caption
  • Filename
  • Date Uploaded
  • Date Modified
  • Date Taken
SquareThumbs boolean
TemplateUri uri
ThemeUri uri Only applies to legacy accounts
Title Deprecated as of 2014-11-20 Use Name instead
TotalSizes integer
UploadKey text Guest UploadKey
UrlName text A human-readable name for use in the URL
UrlPath text
Watermark boolean Automatically apply watermark to uploaded images?
WatermarkUri uri
WorldSearchable boolean

JSON

{
    "Request": {
        "Version": "v2",
        "Method": "GET",
        "Uri": "/api/v2/album/CNm7wz?_responseLevel=Default&_accept=text%2Fhtml"
    },
    "Options": {
        "MethodDetails": {
            "OPTIONS": {
                "Permissions": [
                    "Read"
                ]
            },
            "GET": {
                "Permissions": [
                    "Read"
                ]
            },
            "PATCH": {
                "Permissions": [
                    "Modify"
                ]
            },
            "DELETE": {
                "Permissions": [
                    "Modify"
                ]
            }
        },
        "Methods": [
            "OPTIONS",
            "GET"
        ],
        "MediaTypes": [
            "application/json",
            "application/vnd.php.serialized",
            "application/x-msgpack",
            "text/html",
            "text/csv"
        ],
        "Output": [
            {
                "Name": "NiceName",
                "Description": "Use UrlName instead",
                "Type": "Varchar",
                "MIN_CHARS": 1,
                "MAX_CHARS": 60,
                "Deprecated": "2014-11-20"
            },
            {
                "Name": "UrlName",
                "Description": "A human-readable name for use in the URL",
                "Type": "Varchar",
                "MIN_CHARS": 1,
                "MAX_CHARS": 60
            },
            {
                "Name": "Title",
                "Description": "Use Name instead",
                "Type": "Varchar",
                "MIN_CHARS": 0,
                "MAX_CHARS": 255,
                "Deprecated": "2014-11-20"
            },
            {
                "Name": "Name",
                "Type": "Varchar",
                "MIN_CHARS": 0,
                "MAX_CHARS": 255
            },
            {
                "Name": "PrintmarkUri",
                "Type": "Uri",
                "MAX_LENGTH": "INFINITY",
                "Locator": [
                    "Printmark"
                ]
            },
            {
                "Name": "WatermarkUri",
                "Type": "Uri",
                "MAX_LENGTH": "INFINITY",
                "Locator": [
                    "Watermark"
                ]
            },
            {
                "Name": "ThemeUri",
                "Description": "Only applies to legacy accounts",
                "Type": "Uri",
                "MAX_LENGTH": "INFINITY",
                "Locator": [
                    "Theme"
                ]
            },
            {
                "Name": "TemplateUri",
                "Type": "Uri",
                "MAX_LENGTH": "INFINITY",
                "Locator": [
                    "Template"
                ]
            },
            {
                "Name": "AllowDownloads",
                "Type": "Boolean"
            },
            {
                "Name": "Backprinting",
                "Type": "Varchar",
                "MIN_CHARS": 0,
                "MAX_CHARS": 255
            },
            {
                "Name": "BoutiquePackaging",
                "Type": "Select",
                "OPTIONS": [
                    "No",
                    "Yes",
                    "Inherit from User"
                ],
                "MIN_COUNT": 1,
                "MAX_COUNT": 1
            },
            {
                "Name": "CanRank",
                "Type": "Boolean"
            },
            {
                "Name": "Clean",
                "Type": "Boolean"
            },
            {
                "Name": "Comments",
                "Type": "Boolean"
            },
            {
                "Name": "Description",
                "Type": "Text",
                "MIN_CHARS": 0,
                "MAX_CHARS": 65535
            },
            {
                "Name": "DownloadPassword",
                "Type": "Varchar",
                "MIN_CHARS": 0,
                "MAX_CHARS": 50
            },
            {
                "Name": "EXIF",
                "Type": "Boolean"
            },
            {
                "Name": "External",
                "Description": "An old setting that no longer has any function",
                "Type": "Boolean",
                "Deprecated": "2015-09-08"
            },
            {
                "Name": "FamilyEdit",
                "Type": "Boolean"
            },
            {
                "Name": "Filenames",
                "Type": "Boolean"
            },
            {
                "Name": "FriendEdit",
                "Type": "Boolean"
            },
            {
                "Name": "Geography",
                "Type": "Boolean"
            },
            {
                "Name": "Header",
                "Description": "Appearance",
                "Type": "Select",
                "OPTIONS": [
                    "Custom",
                    "SmugMug"
                ],
                "MIN_COUNT": 1,
                "MAX_COUNT": 1
            },
            {
                "Name": "HideOwner",
                "Type": "Boolean"
            },
            {
                "Name": "InterceptShipping",
                "Description": "Personal Delivery",
                "Type": "Select",
                "OPTIONS": [
                    "No",
                    "Yes",
                    "Inherit from User"
                ],
                "MIN_COUNT": 1,
                "MAX_COUNT": 1
            },
            {
                "Name": "Keywords",
                "Type": "Varchar",
                "MIN_CHARS": 0,
                "MAX_CHARS": 255
            },
            {
                "Name": "LargestSize",
                "Type": "Select",
                "OPTIONS": [
                    "Medium",
                    "Large",
                    "XLarge",
                    "X2Large",
                    "X3Large",
                    "X4Large",
                    "X5Large",
                    "4K",
                    "5K",
                    "Original"
                ],
                "MIN_COUNT": 1,
                "MAX_COUNT": 1
            },
            {
                "Name": "PackagingBranding",
                "Type": "Boolean"
            },
            {
                "Name": "Password",
                "Type": "Varchar",
                "MIN_CHARS": 0,
                "MAX_CHARS": 50
            },
            {
                "Name": "PasswordHint",
                "Type": "Varchar",
                "MIN_CHARS": 0,
                "MAX_CHARS": 255
            },
            {
                "Name": "Printable",
                "Type": "Boolean"
            },
            {
                "Name": "Privacy",
                "Description": "\"Private\" is not supported on legacy accounts",
                "Type": "Select",
                "OPTIONS": [
                    "Public",
                    "Unlisted",
                    "Private"
                ],
                "MIN_COUNT": 1,
                "MAX_COUNT": 1
            },
            {
                "Name": "ProofDays",
                "Type": "Integer",
                "MIN_VALUE": "NEGATIVE_INFINITY",
                "MAX_VALUE": "POSITIVE_INFINITY"
            },
            {
                "Name": "ProofDigital",
                "Type": "Boolean"
            },
            {
                "Name": "Protected",
                "Description": "Right-Click Protection",
                "Type": "Boolean"
            },
            {
                "Name": "Share",
                "Type": "Boolean"
            },
            {
                "Name": "Slideshow",
                "Type": "Boolean"
            },
            {
                "Name": "SmugSearchable",
                "Type": "Select",
                "OPTIONS": [
                    "No",
                    "Inherit from User"
                ],
                "MIN_COUNT": 1,
                "MAX_COUNT": 1
            },
            {
                "Name": "SortDirection",
                "Type": "Select",
                "OPTIONS": [
                    "Ascending",
                    "Descending"
                ],
                "MIN_COUNT": 1,
                "MAX_COUNT": 1
            },
            {
                "Name": "SortMethod",
                "Type": "Select",
                "OPTIONS": [
                    "Position",
                    "Caption",
                    "Filename",
                    "Date Uploaded",
                    "Date Modified",
                    "Date Taken"
                ],
                "MIN_COUNT": 1,
                "MAX_COUNT": 1
            },
            {
                "Name": "SquareThumbs",
                "Type": "Boolean"
            },
            {
                "Name": "UploadKey",
                "Description": "Guest UploadKey",
                "Type": "Varchar",
                "MIN_CHARS": 0,
                "MAX_CHARS": "INFINITY"
            },
            {
                "Name": "Watermark",
                "Description": "Automatically apply watermark to uploaded images?",
                "Type": "Boolean"
            },
            {
                "Name": "WorldSearchable",
                "Type": "Boolean"
            },
            {
                "Name": "SecurityType",
                "Type": "Select",
                "OPTIONS": [
                    "None",
                    "Password",
                    "GrantAccess"
                ],
                "MIN_COUNT": 1,
                "MAX_COUNT": 1
            },
            {
                "Name": "CommerceLightbox",
                "Type": "Boolean"
            },
            {
                "Name": "HighlightAlbumImageUri",
                "Type": "Uri",
                "MAX_LENGTH": "INFINITY",
                "Locator": [
                    "AlbumImage"
                ]
            },
            {
                "Name": "AlbumTemplateUri",
                "Description": "Specify default album presets by providing an AlbumTemplateUri.",
                "Type": "Uri",
                "MAX_LENGTH": "INFINITY",
                "Locator": [
                    "AlbumTemplate"
                ]
            },
            {
                "Name": "AlbumKey",
                "Type": "Varchar",
                "MIN_CHARS": 0,
                "MAX_CHARS": "INFINITY"
            },
            {
                "Name": "CanBuy",
                "Type": "Boolean"
            },
            {
                "Name": "CanFavorite",
                "Type": "Boolean"
            },
            {
                "Name": "FavoriteAlbumUrl",
                "Type": "FullUrl",
                "MIN_CHARS": 0,
                "MAX_CHARS": "INFINITY"
            },
            {
                "Name": "Date",
                "Type": "DateTimeISO8601"
            },
            {
                "Name": "LastUpdated",
                "Type": "DateTimeISO8601"
            },
            {
                "Name": "ImagesLastUpdated",
                "Description": "The last time at which images were added, removed, or rearranged in this album",
                "Type": "DateTimeISO8601"
            },
            {
                "Name": "NodeID",
                "Type": "Varchar",
                "MIN_CHARS": 1,
                "MAX_CHARS": "INFINITY"
            },
            {
                "Name": "OriginalSizes",
                "Type": "Integer",
                "MIN_VALUE": "NEGATIVE_INFINITY",
                "MAX_VALUE": "POSITIVE_INFINITY"
            },
            {
                "Name": "TotalSizes",
                "Type": "Integer",
                "MIN_VALUE": "NEGATIVE_INFINITY",
                "MAX_VALUE": "POSITIVE_INFINITY"
            },
            {
                "Name": "ImageCount",
                "Type": "Integer",
                "MIN_VALUE": "NEGATIVE_INFINITY",
                "MAX_VALUE": "POSITIVE_INFINITY"
            },
            {
                "Name": "UrlPath",
                "Type": "Varchar",
                "MIN_CHARS": 0,
                "MAX_CHARS": "INFINITY"
            },
            {
                "Name": "CanShare",
                "Description": "Does the owner of this album want it to be shareable?",
                "Type": "Boolean"
            },
            {
                "Name": "HasDownloadPassword",
                "Type": "Boolean"
            },
            {
                "Name": "Packages",
                "Description": "Are any packages available for album",
                "Type": "Boolean"
            }
        ],
        "Notes": [
            "To sort images manually first set SortMethod to Position",
            "When selecting SortMethod=Position, SortMethod is automatically set to Ascending",
            "NiceName is deprecated; use UrlName instead",
            "Title is deprecated; use Name instead",
            "AlbumHighlightImage is deprecated, use HighlightImage instead"
        ],
        "ResponseLevels": [
            "Full",
            "Password",
            "Public",
            "GrantAccess"
        ],
        "Path": [
            {
                "type": "path",
                "text": "api"
            },
            {
                "type": "path",
                "text": "v2"
            },
            {
                "type": "path",
                "text": "album"
            },
            {
                "type": "singleparam",
                "param_name": "albumkey",
                "param_value": "CNm7wz",
                "param_validator": {}
            }
        ]
    },
    "Response": {
        "Uri": "/api/v2/album/CNm7wz?_responseLevel=Default",
        "Locator": "Album",
        "LocatorType": "Object",
        "Album": {
            "NiceName": "Tube150mag",
            "UrlName": "Tube150mag",
            "Title": "Tube150 in DigitalSLRPhoto",
            "Name": "Tube150 in DigitalSLRPhoto",
            "AllowDownloads": true,
            "Description": "London Underground Photo Exhibition in the Malaysia edition of <a href=\"http://www.digitalslrphoto.com/\" target=\"_blank\"><i>Digital SLR Photography</i> magazine</a>, June 2013<br><a href=\"http://www.linyangchen.com/tube150\">back to exhibition information</a>",
            "EXIF": false,
            "External": true,
            "Filenames": false,
            "Geography": false,
            "Keywords": "DigitalSLRPhoto; london underground exhibition; tube photography; tube150 exhibition; yangchen lin",
            "PasswordHint": "",
            "Protected": false,
            "SortDirection": "Ascending",
            "SortMethod": "Position",
            "SecurityType": "None",
            "AlbumKey": "CNm7wz",
            "CanBuy": false,
            "CanFavorite": false,
            "LastUpdated": "2013-11-30T21:14:47+00:00",
            "ImagesLastUpdated": "2013-11-30T21:15:56+00:00",
            "NodeID": "WDsRw",
            "ImageCount": 4,
            "UrlPath": "/Tube150mag",
            "CanShare": false,
            "HasDownloadPassword": false,
            "Packages": false,
            "Uri": "/api/v2/album/CNm7wz",
            "WebUri": "https://www.linyangchen.com/Tube150mag",
            "UriDescription": "Album by key",
            "Uris": {
                "AlbumShareUris": {
                    "Uri": "/api/v2/album/CNm7wz!shareuris",
                    "Locator": "AlbumShareUris",
                    "LocatorType": "Object",
                    "UriDescription": "URIs that are useful for sharing",
                    "EndpointType": "AlbumShareUris"
                },
                "Node": {
                    "Uri": "/api/v2/node/WDsRw",
                    "Locator": "Node",
                    "LocatorType": "Object",
                    "UriDescription": "Node with the given id.",
                    "EndpointType": "Node"
                },
                "NodeCoverImage": {
                    "Uri": "/api/v2/node/WDsRw!cover",
                    "Locator": "Image",
                    "LocatorType": "Object",
                    "UriDescription": "Cover image for a folder, album, or page",
                    "EndpointType": "NodeCoverImage"
                },
                "User": {
                    "Uri": "/api/v2/user/yangchen",
                    "Locator": "User",
                    "LocatorType": "Object",
                    "UriDescription": "User By Nickname",
                    "EndpointType": "User"
                },
                "Folder": {
                    "Uri": "/api/v2/folder/user/yangchen",
                    "Locator": "Folder",
                    "LocatorType": "Object",
                    "UriDescription": "A folder or legacy (sub)category by UrlPath",
                    "EndpointType": "Folder"
                },
                "ParentFolders": {
                    "Uri": "/api/v2/folder/user/yangchen!parents",
                    "Locator": "Folder",
                    "LocatorType": "Objects",
                    "UriDescription": "The sequence of parent folders, from the given folder to the root",
                    "EndpointType": "ParentFolders"
                },
                "HighlightImage": {
                    "Uri": "/api/v2/highlight/node/WDsRw",
                    "Locator": "Image",
                    "LocatorType": "Object",
                    "UriDescription": "Highlight image for a folder, album, or page",
                    "EndpointType": "HighlightImage"
                },
                "AlbumHighlightImage": {
                    "Uri": "/api/v2/album/CNm7wz!highlightimage",
                    "Locator": "AlbumImage",
                    "LocatorType": "Object",
                    "UriDescription": "Highlight image for album",
                    "EndpointType": "AlbumHighlightImage"
                },
                "AlbumImages": {
                    "Uri": "/api/v2/album/CNm7wz!images",
                    "Locator": "AlbumImage",
                    "LocatorType": "Objects",
                    "UriDescription": "Images from album",
                    "EndpointType": "AlbumImages"
                },
                "AlbumPopularMedia": {
                    "Uri": "/api/v2/album/CNm7wz!popularmedia",
                    "Locator": "AlbumImage",
                    "LocatorType": "Objects",
                    "UriDescription": "Popular images from album",
                    "EndpointType": "AlbumPopularMedia"
                },
                "AlbumDownload": {
                    "Uri": "/api/v2/album/CNm7wz!download",
                    "Locator": "Download",
                    "LocatorType": "Objects",
                    "UriDescription": "Download album",
                    "EndpointType": "AlbumDownload"
                },
                "AlbumPrices": {
                    "Uri": "/api/v2/album/CNm7wz!prices",
                    "Locator": "CatalogSkuPrice",
                    "LocatorType": "Objects",
                    "UriDescription": "Purchasable Skus",
                    "EndpointType": "AlbumPrices"
                },
                "AlbumPricelistExclusions": {
                    "Uri": "/api/v2/album/CNm7wz!pricelistexclusions",
                    "Locator": "AlbumPricelistExclusions",
                    "LocatorType": "Object",
                    "UriDescription": "Pricelist information for an Album",
                    "EndpointType": "AlbumPricelistExclusions"
                }
            },
            "ResponseLevel": "Public"
        },
        "UriDescription": "Album by key",
        "EndpointType": "Album",
        "DocUri": "https://api.smugmug.com/api/v2/doc/reference/album.html",
        "Timing": {
            "Total": {
                "time": 0.0349,
                "cycles": 1,
                "objects": 0
            }
        }
    },
    "Code": 200,
    "Message": "Ok"
}

Contents

  1. Response
  2. Request
  3. Config
  4. Options
    1. Notes
    2. Available Response Levels
    3. Methods
    4. Available Media Types
    5. Output Fields
  5. JSON