Social Fetch
Start for freeStart free
Flickr hub

Flickr Album API

One album with its metadata and a page of the photos inside it.

GET /v1/flickr/albums/{albumId}

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/flickr/albums/{albumId} needs an album id and a userId, because the album belongs to a person. It returns data.album (title, description, owner, counts including views and comments, sortType, primary photo URL and create/update dates) and a page of data.photos with the same full photo record as a photo lookup.

When the person is given as an alias, it is resolved to an NSID first. An unknown album or owner returns lookupStatus: not_found and a null album. If the extra album metadata is unavailable, the photos still come back and the answer is marked degraded.

Flickr Album API FAQ

Why do I need a user id with the album id?

Albums are addressed by owner and album id together. Pass an NSID or a path alias in the userId parameter.

Does it return every photo in the album?

It returns one page, up to 100 photos. Follow page.nextCursor while page.hasMore is true to walk the album.

How much does an album page cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth. Each paginated page is a separate billed request.

Are the album dates and view count real?

Yes. On the first page the route also reads the album's own metadata, so createdAt, updatedAt, views, comments and primaryPhotoUrl are filled. Unavailable metadata leaves them null or from the photo list and marks the answer degraded.

Other Flickr endpoints