Flickr

List Flickr user galleries

List a Flickr user's galleries; list records have no total or cover images.

GET/v1/flickr/users/{userId}/galleries
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
4
userIdstringrequiredpath

NSID (`12037949754@N01`) or path alias (`bees`).

min 1 chars · max 80 chars · pattern: ^(?:[0-9]{1,20}@N[0-9]{2}|[A-Za-z0-9][A-Za-z0-9._-]{0,79})$

cursorstringoptionalquery

Cursor from `page.nextCursor` of the previous response. It only works with the same filters. Send it without `page`; it keeps the page size it was issued with, so `limit` may be sent again and has no effect.

min 1 chars · max 2048 chars

pageintegeroptionalquery

Page number, 1-based. Default: 1. A page past the last returns an empty list with `hasMore: false`. Prefer `cursor` when continuing.

≥ 1 · ≤ 1000000

limitintegeroptionalquery

Rows per page, 1 to 100. Default: 100.

≥ 1 · ≤ 100

Response fields
64

Endpoint-specific response payload.

datalookupStatus
string

`found` when the entity exists; `not_found` when it does not exist or was deleted; `hidden` when the owner hides the data (EXIF); `private` when the group or pool is member-only; `restricted` when the group is age-restricted.

one of: found, not_found, hidden, private, restricted

A person as shown beside a photo or in a list.

datauserid
stringnullable

NSID.

datauseralias
stringnullable

Path alias used in URLs.

datausername
stringnullable

Display name, with bidi controls removed.

datauserrealName
stringnullable

Real name the person chose to show.

datauserlocation
stringnullable

Location the person chose to show.

datauserisPro
booleannullable

Whether the account is Pro.

datauserproTier
stringnullable

Pro badge, `standard` or `legacy`.

datausercreatedAt
stringnullable

Account creation time, ISO 8601 UTC.

The person's avatar at three sizes.

datauseravatarsmall
stringnullable

Square avatar URL, 100 pixels.

datauseravatarmedium
stringnullable

Avatar URL, 240 pixels.

datauseravatarlarge
stringnullable

Avatar URL, 500 pixels.

datauserprofileUrl
stringnullable

Profile page URL.

datauserphotosUrl
stringnullable

Photostream URL.

Galleries on this page.

datagalleries[]id
string

Gallery id (the part after the dash of the compound id).

datagalleries[]url
stringnullable

Gallery page URL.

datagalleries[]title
stringnullable

Title.

datagalleries[]description
stringnullable

Description as HTML.

A person as shown beside a photo or in a list.

datagalleries[]ownerid
stringnullable

NSID.

datagalleries[]owneralias
stringnullable

Path alias used in URLs.

datagalleries[]ownername
stringnullable

Display name, with bidi controls removed.

datagalleries[]ownerrealName
stringnullable

Real name the person chose to show.

datagalleries[]ownerlocation
stringnullable

Location the person chose to show.

datagalleries[]ownerisPro
booleannullable

Whether the account is Pro.

datagalleries[]ownerproTier
stringnullable

Pro badge, `standard` or `legacy`.

datagalleries[]ownercreatedAt
stringnullable

Account creation time, ISO 8601 UTC.

The person's avatar at three sizes.

datagalleries[]owneravatarsmall
stringnullable

Square avatar URL, 100 pixels.

datagalleries[]owneravatarmedium
stringnullable

Avatar URL, 240 pixels.

datagalleries[]owneravatarlarge
stringnullable

Avatar URL, 500 pixels.

datagalleries[]ownerprofileUrl
stringnullable

Profile page URL.

datagalleries[]ownerphotosUrl
stringnullable

Photostream URL.

Gallery counts.

datagalleries[]countsphotos
integernullable

Photos.

datagalleries[]countsvideos
integernullable

Videos.

datagalleries[]countsviews
integernullable

Views.

datagalleries[]countscomments
integernullable

Comments.

datagalleries[]countstotal
integernullable

Items of every kind; null when the list record does not carry a real count.

datagalleries[]primaryPhotoId
stringnullable

Primary photo id.

Cover images; null when the gallery does not show them.

datagalleries[]coverPhotos[]url
stringnullable

Cover image URL.

datagalleries[]coverPhotos[]width
integernullable

Width.

datagalleries[]coverPhotos[]height
integernullable

Height.

datagalleries[]coverPhotos[]isPrimary
booleannullable

Whether this is the primary cover.

datagalleries[]coverPhotos[]isVideo
booleannullable

Whether the cover is a video.

datagalleries[]createdAt
stringnullable

Creation time, ISO 8601 UTC.

datagalleries[]updatedAt
stringnullable

Last change, ISO 8601 UTC.

Pagination state for the current page.

datapagepage
integer

Current page number.

≥ 0

datapagehasMore
boolean

Whether another page is available.

datapagenextPage
integernullable

Next page number; null on the last page.

≥ 0

datapagenextCursor
stringnullable

Cursor for the next page; null on the last page.

datapagetotalItems
integernullable

Total rows in the whole list; null when no usable total is available, including a page past the end and a photo search with a taken time bound. It can change between calls.

datapagereachableItems
integernullable

Rows this endpoint can reach. Smaller than `totalItems` where this endpoint stops early. Null when `totalItems` is null.

datapagelimit
integer

Rows requested for this page.

≥ 0

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/flickr/users/nasa2explore/galleries" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Flickr galleries.