Social Fetch
Start for freeStart free
Flickr hub

Flickr Profile API

A public photographer profile with identity, counts, links and profile text.

GET /v1/flickr/users/{userId}

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/flickr/users/{userId} accepts an NSID such as 12037949754@N01 or a path alias such as bees. On found, data.user carries id, alias, name, realName, location, isPro, createdAt (UTC), avatar, profileUrl, photosUrl, description as HTML, descriptionText as plain text, hometown, city, country, occupation, website, social handles and URLs, testimonials, popularPhotos, and counts for photos, followers, following, views, tags, geotagged photos, favourites and photos in groups.

profileAvailable says whether the public profile record is included and countsAvailable says whether the follower, following, view and other totals are included. When those totals are unavailable, identity and the profile record still come back, the totals and related fields are null or empty, and the answer is marked degraded, so an unavailable total does not turn a known account into a miss. For accounts with more than 1,000,000 photos, followers, views, tags, geotagged, favorites and photosInGroups are always null; photos and following are filled. An unknown alias or NSID returns lookupStatus: not_found.

Flickr Profile API FAQ

How do I name the person?

Pass the NSID, such as 12037949754@N01, or the path alias, such as bees or library_of_congress.

Which counts are included?

counts.photos, followers, following, views, tags, geotagged, favorites and photosInGroups where the public records carry them. Fields the records do not expose are null, not zero.

Why are some counts null for a very large account?

For accounts with more than 1,000,000 photos, followers, views, tags, geotagged, favorites and photosInGroups are always null; photos and following are filled. Other missing counts are null, not zero.

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

What does profileAvailable false mean?

The account was found but the public profile record was not available, so the profile fields are null. The account is still found; a later request can fill the profile fields.

Other Flickr endpoints