Get Flickr user

GET/v1/flickr/users/{userId}

1credit

Headers

Get your API key

x-api-keystringheader

API key (`sfk_...`)

Parameters

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})$

Response fields

180

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 public Flickr profile.

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.

datauserdescription

stringnullable

Profile text as HTML.

datauserdescriptionText

stringnullable

Profile text as plain text, with markup removed and entities decoded.

datauseremail

stringnullable

Email address the person typed into their public profile contact field; null when not shown.

datauserhometown

stringnullable

Hometown.

datausercity

stringnullable

City.

datausercountry

stringnullable

Country.

datauseroccupation

stringnullable

Occupation.

datauserwebsite

stringnullable

Website the person lists.

datauserfirstName

stringnullable

First name.

datauserlastName

stringnullable

Last name.

Handles typed into the public profile and the URLs for them.

datausersocialfacebook

stringnullable

Facebook handle the person lists.

datausersocialfacebookUrl

stringnullable

Facebook profile URL.

datausersocialinstagram

stringnullable

Instagram handle the person lists.

datausersocialinstagramUrl

stringnullable

Instagram profile URL.

datausersocialtwitter

stringnullable

Twitter handle the person lists.

datausersocialtwitterUrl

stringnullable

Twitter profile URL.

datausersocialtumblr

stringnullable

Tumblr handle the person lists.

datausersocialtumblrUrl

stringnullable

Tumblr profile URL.

datausersocialpinterest

stringnullable

Pinterest handle the person lists.

datausersocialpinterestUrl

stringnullable

Pinterest profile URL.

Public testimonials on the profile.

datausertestimonials[]id

string

Testimonial id.

Person who wrote it; null when deleted.

datausertestimonials[]byUserid

stringnullable

NSID.

datausertestimonials[]byUseralias

stringnullable

Path alias used in URLs.

datausertestimonials[]byUsername

stringnullable

Display name, with bidi controls removed.

datausertestimonials[]byUserrealName

stringnullable

Real name the person chose to show.

datausertestimonials[]byUserlocation

stringnullable

Location the person chose to show.

datausertestimonials[]byUserisPro

booleannullable

Whether the account is Pro.

datausertestimonials[]byUserproTier

stringnullable

Pro badge, `standard` or `legacy`.

datausertestimonials[]byUsercreatedAt

stringnullable

Account creation time, ISO 8601 UTC.

The person's avatar at three sizes.

datausertestimonials[]byUseravatarsmall

stringnullable

Square avatar URL, 100 pixels.

datausertestimonials[]byUseravatarmedium

stringnullable

Avatar URL, 240 pixels.

datausertestimonials[]byUseravatarlarge

stringnullable

Avatar URL, 500 pixels.

datausertestimonials[]byUserprofileUrl

stringnullable

Profile page URL.

datausertestimonials[]byUserphotosUrl

stringnullable

Photostream URL.

datausertestimonials[]body

stringnullable

Testimonial text as HTML.

datausertestimonials[]createdAt

stringnullable

When it was written, ISO 8601 UTC.

The profile's most popular photos.

datauserpopularPhotos[]id

string

Photo id.

datauserpopularPhotos[]url

stringnullable

Photo page URL.

datauserpopularPhotos[]shortUrl

stringnullable

Short link, e.g. `https://flic.kr/p/4AK2sc`.

datauserpopularPhotos[]title

stringnullable

Title.

datauserpopularPhotos[]description

stringnullable

Description as HTML, as the owner wrote it.

datauserpopularPhotos[]mediaType

stringnullable

`photo` or `video`.

datauserpopularPhotos[]mediaStatus

stringnullable

Processing state, e.g. `ready`.

datauserpopularPhotos[]contentType

integernullable

1 photo, 2 screenshot or other.

datauserpopularPhotos[]safetyLevel

integernullable

0 safe, 1 moderate, 2 restricted.

The photo's licence.

datauserpopularPhotos[]licenseid

integernullable

Licence id, 0 to 16.

datauserpopularPhotos[]licensename

stringnullable

Licence name for ids 0 to 16; null for an id outside that table.

datauserpopularPhotos[]licenseurl

stringnullable

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.

datauserpopularPhotos[]ownerid

stringnullable

NSID.

datauserpopularPhotos[]owneralias

stringnullable

Path alias used in URLs.

datauserpopularPhotos[]ownername

stringnullable

Display name, with bidi controls removed.

datauserpopularPhotos[]ownerrealName

stringnullable

Real name the person chose to show.

datauserpopularPhotos[]ownerlocation

stringnullable

Location the person chose to show.

datauserpopularPhotos[]ownerisPro

booleannullable

Whether the account is Pro.

datauserpopularPhotos[]ownerproTier

stringnullable

Pro badge, `standard` or `legacy`.

datauserpopularPhotos[]ownercreatedAt

stringnullable

Account creation time, ISO 8601 UTC.

The person's avatar at three sizes.

datauserpopularPhotos[]owneravatarsmall

stringnullable

Square avatar URL, 100 pixels.

datauserpopularPhotos[]owneravatarmedium

stringnullable

Avatar URL, 240 pixels.

datauserpopularPhotos[]owneravatarlarge

stringnullable

Avatar URL, 500 pixels.

datauserpopularPhotos[]ownerprofileUrl

stringnullable

Profile page URL.

datauserpopularPhotos[]ownerphotosUrl

stringnullable

Photostream URL.

Dates attached to a photo.

datauserpopularPhotos[]datestakenAt

stringnullable

Owner-local time (`YYYY-MM-DD HH:MM:SS`), with no zone.

datauserpopularPhotos[]datestakenGranularity

integernullable

0 exact, 4 month, 6 year, 8 circa; null when not recorded.

datauserpopularPhotos[]datestakenUnknown

booleannullable

Whether the owner marked the date unknown.

datauserpopularPhotos[]datespostedAt

stringnullable

Upload time, ISO 8601 UTC.

datauserpopularPhotos[]dateslastUpdateAt

stringnullable

Last metadata change, ISO 8601 UTC.

datauserpopularPhotos[]datesaddedAt

stringnullable

Time added to a pool, ISO 8601 UTC.

datauserpopularPhotos[]datesfavoritedAt

stringnullable

Time favourited, ISO 8601 UTC.

Counts attached to a photo.

datauserpopularPhotos[]countsviews

integernullable

Views.

datauserpopularPhotos[]countsfavorites

integernullable

Times favourited.

datauserpopularPhotos[]countscomments

integernullable

Comments.

datauserpopularPhotos[]countsnotes

integernullable

Notes.

Original dimensions; null when not shown.

Size of the original file.

datauserpopularPhotos[]dimensionsoriginalwidth

integernullable

Original width.

datauserpopularPhotos[]dimensionsoriginalheight

integernullable

Original height.

Every size available, including `o` (the original) where shown.

datauserpopularPhotos[]sizes[]key

string

Size key: `sq`, `z`, `k`, `o` (the original).

datauserpopularPhotos[]sizes[]label

stringnullable

Display label, e.g. `Square` or `Large 2048`.

datauserpopularPhotos[]sizes[]url

stringnullable

Image URL.

datauserpopularPhotos[]sizes[]width

integernullable

Width in pixels.

datauserpopularPhotos[]sizes[]height

integernullable

Height in pixels.

datauserpopularPhotos[]sizes[]media

stringnullable

`photo` or `video`.

Tags.

datauserpopularPhotos[]tags[]

stringoptional

Where the photo was taken.

datauserpopularPhotos[]geolatitude

numbernullable

Latitude.

datauserpopularPhotos[]geolongitude

numbernullable

Longitude.

datauserpopularPhotos[]geoaccuracy

integernullable

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.

datauserpopularPhotos[]geoplaceneighbourhoodname

stringnullable

Place name.

datauserpopularPhotos[]geoplaceneighbourhoodwoeId

stringnullable

WOE id.

One level of the place hierarchy.

datauserpopularPhotos[]geoplacelocalityname

stringnullable

Place name.

datauserpopularPhotos[]geoplacelocalitywoeId

stringnullable

WOE id.

One level of the place hierarchy.

datauserpopularPhotos[]geoplacecountyname

stringnullable

Place name.

datauserpopularPhotos[]geoplacecountywoeId

stringnullable

WOE id.

One level of the place hierarchy.

datauserpopularPhotos[]geoplaceregionname

stringnullable

Place name.

datauserpopularPhotos[]geoplaceregionwoeId

stringnullable

WOE id.

One level of the place hierarchy.

datauserpopularPhotos[]geoplacecountryname

stringnullable

Place name.

datauserpopularPhotos[]geoplacecountrywoeId

stringnullable

WOE id.

Always null: photo locations do not name a venue.

datauserpopularPhotos[]geoplacevenuename

stringnullable

Venue name.

datauserpopularPhotos[]geoplacevenuewoeId

stringnullable

WOE id.

datauserpopularPhotos[]geoplacevenuefoursquareId

stringnullable

Foursquare venue id.

Notes placed on the photo.

datauserpopularPhotos[]notes[]id

stringnullable

Note id.

datauserpopularPhotos[]notes[]photoId

stringnullable

Photo the note is on.

datauserpopularPhotos[]notes[]author

stringnullable

Author NSID.

datauserpopularPhotos[]notes[]authorName

stringnullable

Author display name.

datauserpopularPhotos[]notes[]authorRealName

stringnullable

Author real name.

datauserpopularPhotos[]notes[]authorIsPro

booleannullable

Whether the author is Pro.

datauserpopularPhotos[]notes[]authorIsDeleted

booleannullable

Whether the author's account is deleted.

datauserpopularPhotos[]notes[]x

integernullable

Left position in pixels.

datauserpopularPhotos[]notes[]y

integernullable

Top position in pixels.

datauserpopularPhotos[]notes[]width

integernullable

Width in pixels.

datauserpopularPhotos[]notes[]height

integernullable

Height in pixels.

datauserpopularPhotos[]notes[]text

stringnullable

Note text.

Video state. Playback URLs are signed and are not returned.

datauserpopularPhotos[]videoready

integernullable

1 when the video is ready.

datauserpopularPhotos[]videofailed

integernullable

1 when processing failed.

datauserpopularPhotos[]videopending

integernullable

1 while processing.

datauserpopularPhotos[]videodurationSeconds

integernullable

Length in seconds.

datauserpopularPhotos[]videowidth

integernullable

Playback width.

datauserpopularPhotos[]videoheight

integernullable

Playback height.

datauserpopularPhotos[]originalFormat

stringnullable

Original file format, e.g. `jpg`; null when the photo does not show one.

datauserpopularPhotos[]rotation

integernullable

Rotation the owner set.

datauserpopularPhotos[]isPublic

booleannullable

Whether the photo is public.

datausershowcaseAlbumId

stringnullable

Album shown in the profile's showcase slot.

Cover photo URLs; null when the account has none.

datausercoverPhotoh

stringnullable

Cover, 1600 pixels.

datausercoverPhotol

stringnullable

Cover, 1024 pixels.

datausercoverPhotos

stringnullable

Cover, 240 pixels.

datausercoverPhotot

stringnullable

Cover, 100 pixels.

Counts on the public profile.

datausercountsphotos

integernullable

Photos.

datausercountsfollowers

integernullable

Followers.

datausercountsfollowing

integernullable

Accounts followed.

datausercountsviews

integernullable

Lifetime photo views.

datausercountstags

integernullable

Tagged photos, as the public profile reports them; this can differ slightly from the user's tag list.

datausercountsgeotagged

integernullable

Geotagged photos.

datausercountsfavorites

integernullable

Photos favourited.

datausercountsphotosInGroups

integernullable

Photos added to groups.

dataprofileAvailable

boolean

False when the account was found but the public profile record was not available; profile fields are then null.

datacountsAvailable

booleanoptional

False when the follower, following, view and other totals are unavailable; those counts and the related fields are then null or empty.

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

Headers

Code example

Responses