Flickr Galleries API
A user’s curated galleries with counts and covers, page by page.
GET /v1/flickr/users/{userId}/galleries1 credit Failed requests are free
About this endpoint
GET /v1/flickr/users/{userId}/galleries returns data.user and a page of data.galleries. A gallery carries id, url, title, description, owner (with alias derived from the gallery URL), counts (photos, videos, views, comments and total), primaryPhotoId, coverPhotos and createdAt/updatedAt.
The list record has no real counts.total or cover images, so both are null here; GET /v1/flickr/galleries/{galleryId} gives the real total and covers. A page can carry fewer than limit rows while more galleries remain. Galleries are curated sets that can mix photos from several photographers, so owner is the gallery owner rather than the photographer of each item. Use GET /v1/flickr/galleries/{galleryId} to read the photos and GET /v1/flickr/galleries/{galleryId}/comments for its comments.
Flickr Galleries API FAQ
What is the difference between an album and a gallery?
An album holds one person’s photos. A gallery is a curated set that can include photos from several people, and it has its own id and comment list.
What do coverPhotos contain?
On a gallery lookup, up to 10 cover image records with url, width, height, isPrimary and isVideo. The list record omits covers, so coverPhotos is null in this list; it is not an empty gallery.
How much does a gallery 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.
Does this route include the gallery’s photos?
No. It lists the person’s galleries. Call GET /v1/flickr/galleries/{galleryId} for one gallery and a page of its photos.
Other Flickr endpoints
- PhotoGET /v1/flickr/photos/{photoId}
- CommentsGET /v1/flickr/photos/{photoId}/comments
- EXIFGET /v1/flickr/photos/{photoId}/exif
- Favourited byGET /v1/flickr/photos/{photoId}/favorites
- ContextsGET /v1/flickr/photos/{photoId}/contexts
- UserGET /v1/flickr/users/{userId}
- PhotostreamGET /v1/flickr/users/{userId}/photos
- AlbumsGET /v1/flickr/users/{userId}/albums