Get Album Metadata

Returns album-level metadata with a structured, documented response containing photo counts, collection status, and unread message counts per album.

The response is cached server-side for 1 minute; the same TTL is advertised via the Cache-Control header and the cache_ttl_seconds field in the body.

If album_ids is omitted, all non-deleted albums for the account are returned, capped at 500. Pass album_ids explicitly for stable, bounded responses.

Related: Get information about an album, Get content count, List albums.

Supports If-None-Match / ETag caching. The ETag rotates with the 60-second server cache bucket.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

Account identifier. When provided it must match the account resolved from the api_key, otherwise the request is rejected with 403.

string

Optional comma-separated list of album IDs to filter by. Maximum 500 ids per request. Ids that do not belong to the account or that have been deleted are silently dropped.

Responses

304

Not Modified. Returned when the request If-None-Match header matches the current cached response ETag.

Language
Credentials
Query
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json