List Flickr user photos
List a Flickr user's photostream, newest first, with full photo records.
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.
Photos on this page.
Photo id.
Photo page URL.
Short link, e.g. `https://flic.kr/p/4AK2sc`.
Title.
Description as HTML, as the owner wrote it.
`photo` or `video`.
Processing state, e.g. `ready`.
1 photo, 2 screenshot or other.
0 safe, 1 moderate, 2 restricted.
The photo's licence.
Licence id, 0 to 16.
Licence name for ids 0 to 16; null for an id outside that table.
Licence URL for ids 0 to 16; null for an id outside that table.
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.
Dates attached to a photo.
Owner-local time (`YYYY-MM-DD HH:MM:SS`), with no zone.
0 exact, 4 month, 6 year, 8 circa; null when not recorded.
Whether the owner marked the date unknown.
Upload time, ISO 8601 UTC.
Last metadata change, ISO 8601 UTC.
Time added to a pool, ISO 8601 UTC.
Time favourited, ISO 8601 UTC.
Counts attached to a photo.
Views.
Times favourited.
Comments.
Notes.
Original dimensions; null when not shown.
Size of the original file.
Original width.
Original height.
Every size available, including `o` (the original) where shown.
Size key: `sq`, `z`, `k`, `o` (the original).
Display label, e.g. `Square` or `Large 2048`.
Image URL.
Width in pixels.
Height in pixels.
`photo` or `video`.
Tags.
Where the photo was taken.
Latitude.
Longitude.
Accuracy code.
Place hierarchy from the full photo record; null on list and search rows, which carry coordinates only.
One level of the place hierarchy.
Place name.
WOE id.
One level of the place hierarchy.
Place name.
WOE id.
One level of the place hierarchy.
Place name.
WOE id.
One level of the place hierarchy.
Place name.
WOE id.
One level of the place hierarchy.
Place name.
WOE id.
Always null: photo locations do not name a venue.
Venue name.
WOE id.
Foursquare venue id.
Notes placed on the photo.
Note id.
Photo the note is on.
Author NSID.
Author display name.
Author real name.
Whether the author is Pro.
Whether the author's account is deleted.
Left position in pixels.
Top position in pixels.
Width in pixels.
Height in pixels.
Note text.
Video state. Playback URLs are signed and are not returned.
1 when the video is ready.
1 when processing failed.
1 while processing.
Length in seconds.
Playback width.
Playback height.
Original file format, e.g. `jpg`; null when the photo does not show one.
Rotation the owner set.
Whether the photo is public.
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/photos?limit=50" \
-H "x-api-key: YOUR_API_KEY"Responses
Flickr photostream.