Flickr hub

Flickr Photostream API

A user’s photos, newest first, with the same full record as a single photo lookup.

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

1 credit Failed requests are free

About this endpoint

GET /v1/flickr/users/{userId}/photos returns data.user (a short profile summary) and a page of data.photos, newest first. Each row is the full photo record: id, title, description, owner, dates, counts, licence, sizes, tags, geo, notes and video state. The route accepts an NSID or a path alias.

Use limit (1 to 100, default 100) and follow page.nextCursor while page.hasMore is true. page.totalItems is the total rows in the list and can change between calls; page.reachableItems is how many rows this route can reach. An unknown person returns lookupStatus: not_found with an empty list.

Flickr Photostream API FAQ

How do I name the person?

Use the NSID or path alias, for example bees or 12037949754@N01. Both forms work for this list.

Are the rows full photo records?

Yes. Each row carries sizes, counts, dates, licence, tags, geo and the owner summary, not just an id and a title.

How much does a photostream 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.

How do I page through a large photostream?

Set limit up to 100 and follow page.nextCursor while page.hasMore is true. A cursor is bound to the filters it was issued for, so start again without a cursor if you change them.