Social Fetch
Start for freeStart free
Flickr hub

Flickr Albums API

A user’s albums with photo counts, covers and sort order, page by page.

GET /v1/flickr/users/{userId}/albums

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/flickr/users/{userId}/albums returns data.user and a page of data.albums. Each album carries id, url, title, description, owner, counts (photos, videos, publicPhotos, views and comments), sortType, primaryPhotoId, primaryPhotoUrl, createdAt and updatedAt.

sortType tells you how the owner arranged the album, for example manual-add-to-end. Use the album id with GET /v1/flickr/albums/{albumId} to read the photos inside. Paging uses limit, page and page.nextCursor, with at most 100 albums a page.

Flickr Albums API FAQ

How do I list the photos in one album?

Take the album id from this response and call GET /v1/flickr/albums/{albumId} with your user id. This route lists albums, not their photos.

What is primaryPhotoUrl?

A 150 pixel cover image URL when the album record carries the photo secret. It can be null for an album without an available cover.

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 create and update dates always present?

Not always. The album list carries them when the record shows them; the single album route can return null dates because its primary request does not include them.

Other Flickr endpoints