Albums

WIP. No idea what SpankBank, pressie albums and paywalled albums are.

AlbumExpirationType

"INDEFINITE" or 0 — "Indefinitely"
"ONCE" or 1 — "View Once", limited by 30 minutes from request
"TEN_MINUTES" or 2 — "For 10 Minutes"
"ONE_HOUR" or 3 — "For 60 Minutes"
"ONE_DAY" or 4 — "For 24 Hours"

Previously shared albums in chat inherit new expirationType settings from newer sharings of the album.

AlbumPreview

albumId — long integer
albumNumber — integer or null if album has expired or was locked
totalAlbumsShared — integer or null if album has expired or was locked
hasUnseenContent — boolean

AlbumMin

everything from AlbumPreview
albumName — appears to always be null
profileId — integer
albumViewable — boolean

AlbumDetails

sharedCount — integer
createdAt — string, date formatted as ISO 8601, e.g. 2026-03-27T20:39:00
updatedAt — string, date formatted as ISO 8601, e.g. 2026-03-27T20:39:00

AlbumExpiration

expiresAt — unix timestamp in milliseconds or null
expirationType — AlbumExpirationType

AlbumContentMin

contentId — long integer
contentType — string
coverUrl — AlbumCoverUrl
statusId — unknown integer, WIP

AlbumContent

everything from AlbumContentMin
thumbUrl — string, unblurred preview, see Media -> Signed CDN files
url — string, original file, see Media -> Signed CDN files, may be "" if remainingViews is 0
processing — boolean
rejectionId - unknown or null

AlbumCoverUrl

String with URL or null, blurred downscaled preview.

JPEG photo with the first frame of video in case of video files.

Becomes unavailable (AccessDenied) after album has expired.

See Media -> Signed CDN files.

Album name

String, may be empty ("") or null, non-string values are coerced into string.

Maximum length: 255 UTF-8 bytes, which is 255 characters for ASCII strings (1 ASCII character is encoded as 1 byte) but less if you include emojis or non-ascii characters (2+ bytes/one codepoit).

Get my albums

Requires Authorization.

GET /v1/albums

Response:

albums — array of objects
- everything from AlbumDetails
- albumId — long integer
- albumName — Album name
- profileId — integer
- version — integer
- content — AlbumContent
- isShareable — boolean

Get an album

Requires Authorization.

GET /v2/albums/{albumId}

Response:

everything from AlbumMin
everything from AlbumDetails
content — array of objects
- everything from AlbumContent
- remainingViews — integer, might be -1; absent if this is your album

Errors:

HTTP status 403 — if you don't have access to album or it doesn't exist

Get an album media poster

Requires Authorization.

GET /v1/albums/{albumId}/content/{contentId}/poster

Response:

blurredPosterUrl — string, see Media -> Signed CDN files
posterUrl — string, see Media -> Signed CDN files

Record view of an album

Repeated requests after invoking this endpoint on view ONCE albums cause HTTP status 403 Forbidden and Action not permitted error.

GET /v3/albums/{albumId}/view

Response:

Empty

Record view of media in an album

Requires Authorization.

Repeated requests after reaching remainingViews=0 do not cause any errors.

POST /v1/albums/{albumId}/view/content/{contentId}

Response:

remainingViews — integer

Get info about profile's album

Requires Authorization.

POST /v2/albums/shares

Body:

profileId — integer

Response:

profileId — long integer
hasAlbum — boolean
hasSharedWithMe — boolean

Get albums shared by a profile

Requires Authorization.

GET /v2/albums/shares/{profileId}

Response:

albums — array of objects
- everything from AlbumMin
- everything from AlbumExpiration
- content — a single AlbumContentMin, a blurred preview
- contentCount — object
  - imageCount — integer
  - videoCount — integer

Create an album

Requires Authorization.

POST /v2/albums

Body:

albumName — Album name

Response:

albumId — long integer

Error:

HTTP status 402 Payment required if you reached limit for number of created albums

Rename an album

Requires Authorization.

PUT /v2/albums/{albumId}

Body:

albumName — Album name

Response:

albumId — integer
albumName — Album name

Delete an album

Requires Authorization.

Repeated requests cause 403 Forbidden and Action not permitted error.

DELETE /v1/albums/{albumId}

Response:

Empty

Upload media to an album

Requires Authorization.

Repeated requests with the same file (its contents) are skipped and a cached result from the first upload request is returned.

POST /v1/albums/{albumId}/content

Query:

width — number, optional, doesn't affect the resulting image
height — number, optional, doesn't affect the resulting image
isFresh — boolean, optional, unknown how it affects the resulting image, WIP

Body:

Content-Type: multipart/form-data

content — file to upload

Response:

contentId — Media file ID
contentUrl — null

Reorder media in an album

Requires Authorization.

POST /v1/albums/{albumId}/content/order

Body:

contentIds — array of long integers, each Media file ID must appear exactly once

Delete media from an album

Requires Authorization.

Technically, this does not delete the media from CDN. All signed URLs will continue to work until expired. Uploading same file will result in getting it assigned the same contentId.

DELETE /v1/albums/{albumId}/content/{contentId}

Response:

Empty

Albums content processing, WIP

WIP

GET /v1/albums/{albumId}/content/{contentId}/processing

Response:

processing — boolean

Pics, WIP

GET /v1/pics/limited/status . UnlimitedPhotoStatusResponse

Response:

available — integer
total — integer

Pics expiring, WIP

POST /v4/pics/expiring ExpiringPhotoReportSentRequest ExpiringPhotoStatusResponse

Pics expiring status, WIP

GET /v4/pics/expiring/status . ExpiringPhotoStatusResponse

Videos expiring status, WIP

GET /v4/videos/expiring/status . PrivateVideoStatusResponse

Get album shares

Requires Authorization.

Returns profiles the album was shared with.

GET /v1/albums/{albumId}/shares

Response:

profileIds — array of integers

Requires Authorization.

Automatically sends the shared album to chat with all listed profiles.

POST /v4/albums/{albumId}/shares

Body:

profiles — array of objects
- expirationType — AlbumExpirationType
- profileId — integer

Response:

Empty

Unshare an album

Requires Authorization.

PUT /v1/albums/{albumId}/unshares

Body:

profiles — array of objects
- profileId — long integer
- shareId — unknown integer, can be 0

Response:

Empty

Unshare an album from everybody

WIP

Unknown, returns 403

PUT /v1/albums/{albumId}/shares/remove

Albums content chat list-by-id, WIP

WIP

Unknown, {"ids":[852120758]} returns 400

POST /v1/albums/{albumId}/content/chat/list-by-id

Query:

isFresh — boolean

Body:

ids — array of long integers

Get album limits

Requires Authorization.

GET /v1/albums/storage

Interestingly, /v2/albums/storage appears to exist, though not used in current version of APK.

Response:

subscriptionType — string, e.g. FreeAlbums
maxAlbums — integer
maxContentItemsPerAlbum — integer
maxShares — integer
maxViewableAlbums — integer
maxViewableVideos — integer
maxContentSize — long integer, size in bytes
maxContentSizeHumanReadable — string, incorrectly uses decimal multiples notation (MB) when in fact calculates binary notation (MiB), so API's 120.00 MB is actually 120 MiB or 125.8291 MB
maxVideoLength — long integer, length in milliseconds (1/1000th of a second)
minVideoLength — long integer, length in milliseconds (1/1000th of a second)
maxShareableAlbums — integer
maxVideosPerAlbum — integer

Albums red dot, WIP

This may just be tracking but could also be related to something else

PUT /v1/albums/red-dot

Response:

Empty.

Gets albums shared with us

Requires Authorization.

POST /v3/pressie-albums/feed

Body:

isFavorite — boolean, optional, only albums shared by favorite users
isOnline — boolean, optional, only albums shared by currently online users
onlyVideo — boolean, optional, only albums with at least one video
blur — boolean, optional, blur media urls in response

Response:

profileFeeds - array of objects
- profileId — integer
- paywallStatus — string, e.g. ALLOW
- seen - boolean
- content — object
- profile — object
  - profileId — long integer
  - name — string, may be empty
  - profileUrl — string or null
  - onlineUntil — unknown or null
  - distanceKm — float or null
sharedAlbums - array of objects
- everything from AlbumPreview
- albumViewable — boolean
- albumVersion — integer
- expiresat — unix timestamp in milliseconds or null (observed key spelling; may also appear as expiresAt)
- name — Album name
- ownerProfileId — integer
- imageCount — integer
- videoCount — integer
- coverContent — object
  - id — long integer
  - contentType — string
  - coverContent — AlbumCoverUrl
  - status — string, e.g. ACTIVE
- profile — object
  - profileId — long integer
  - name — string, may be empty
  - profileUrl — string or null
  - onlineUntil — unknown or null
  - distanceKm — float or null
experimentStatus - number
nonEmptyPersonalAlbumCount - number
emptyAlbumId - null

Pressie albums feed paywall

POST /v3/pressie-albums/feed/paywall/

No body.

Response:

albumPaywallContent - array of objects
- albumId — long integer
- profile — object
  - profileId — long integer
  - name — string, may be empty
  - profileUrl — string or null
  - onlineUntil — unknown or null
  - distanceKm — float or null
- paywallCoverUrl — string, see Media -> Signed CDN files
- paywallUrls — array of strings, see Media -> Signed CDN files
- albumsItemCount — integer

Pressie albums feed profile ID, WIP

WIP

GET /v3/pressie-albums/feed/{profileId}

Pressie albums feed update read, WIP

WIP

POST /v3/pressie-albums/feed/update/read

Albums ​

AlbumExpirationType ​

AlbumPreview ​

AlbumMin ​

AlbumDetails ​

AlbumExpiration ​

AlbumContentMin ​

AlbumContent ​

AlbumCoverUrl ​

Album name ​

Get my albums ​

Get an album ​

Get an album media poster ​

Record view of an album ​

Record view of media in an album ​

Get info about profile's album ​

Get albums shared by a profile ​

Create an album ​

Rename an album ​

Delete an album ​

Upload media to an album ​

Reorder media in an album ​

Delete media from an album ​

Albums content processing, WIP ​

Pics, WIP ​

Pics expiring, WIP ​

Pics expiring status, WIP ​

Videos expiring status, WIP ​

Get album shares ​

Share an album ​

Unshare an album ​

Unshare an album from everybody ​

Albums content chat list-by-id, WIP ​

Get album limits ​

Albums red dot, WIP ​

Gets albums shared with us ​

Pressie albums feed paywall ​

Pressie albums feed profile ID, WIP ​

Pressie albums feed update read, WIP ​

Albums

AlbumExpirationType

AlbumPreview

AlbumMin

AlbumDetails

AlbumExpiration

AlbumContentMin

AlbumContent

AlbumCoverUrl

Album name

Get my albums

Get an album

Get an album media poster

Record view of an album

Record view of media in an album

Get info about profile's album

Get albums shared by a profile

Create an album

Rename an album

Delete an album

Upload media to an album

Reorder media in an album

Delete media from an album

Albums content processing, WIP

Pics, WIP

Pics expiring, WIP

Pics expiring status, WIP

Videos expiring status, WIP

Get album shares

Share an album

Unshare an album

Unshare an album from everybody

Albums content chat list-by-id, WIP

Get album limits

Albums red dot, WIP

Gets albums shared with us

Pressie albums feed paywall

Pressie albums feed profile ID, WIP

Pressie albums feed update read, WIP