List Flickr user albums
List a Flickr user's albums with counts and cover photos.
Headers
Get your API keyAPI key (`sfk_...`)
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})$
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
Page number, 1-based. Default: 1. A page past the last returns an empty list with `hasMore: false`. Prefer `cursor` when continuing.
≥ 1 · ≤ 1000000
Rows per page, 1 to 100. Default: 100.
≥ 1 · ≤ 100
Endpoint-specific response payload.
`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.
NSID.
Path alias used in URLs.
Display name, with bidi controls removed.
Real name the person chose to show.
Location the person chose to show.
Whether the account is Pro.
Pro badge, `standard` or `legacy`.
Account creation time, ISO 8601 UTC.
The person's avatar at three sizes.
Square avatar URL, 100 pixels.
Avatar URL, 240 pixels.
Avatar URL, 500 pixels.
Profile page URL.
Photostream URL.
Albums on this page.
Album id.
Album page URL.
Title.
Description as HTML.
A person as shown beside a photo or in a list.
NSID.
Path alias used in URLs.
Display name, with bidi controls removed.
Real name the person chose to show.
Location the person chose to show.
Whether the account is Pro.
Pro badge, `standard` or `legacy`.
Account creation time, ISO 8601 UTC.
The person's avatar at three sizes.
Square avatar URL, 100 pixels.
Avatar URL, 240 pixels.
Avatar URL, 500 pixels.
Profile page URL.
Photostream URL.
Album counts.
Photos.
Videos.
Public photos.
Views.
Comments.
How the owner sorts it, e.g. `manual-add-to-end`.
Primary photo id.
Primary photo URL, 150 pixels, when the record carries its secret.
Creation time, ISO 8601 UTC.
Last change, ISO 8601 UTC.
Pagination state for the current page.
Current page number.
≥ 0
Whether another page is available.
Next page number; null on the last page.
≥ 0
Cursor for the next page; null on the last page.
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.
Rows this endpoint can reach. Smaller than `totalItems` where this endpoint stops early. Null when `totalItems` is null.
Rows requested for this page.
≥ 0
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/flickr/users/bees/albums" \
-H "x-api-key: YOUR_API_KEY"Responses
Flickr albums.