Social Fetch
Start for freeStart free
Flickr hub

Flickr Photo API

One photo with every size, its counts, dates, licence and the owner who posted it.

GET /v1/flickr/photos/{photoId}

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/flickr/photos/{photoId} takes the digits from a photo URL and returns data.photo on found. The record carries title, description, mediaType, contentType, safetyLevel, originalFormat and rotation, plus license.id, owner (with alias and profileUrl), dates.postedAt and dates.takenAt, counts.views, favorites, comments and notes, dimensions.original, and sizes[] with key, label, url, width, height and media.

tags is a string list, geo holds latitude, longitude, accuracy and the place hierarchy when present, notes holds any note boxes, and video reports processing state and duration without playback URLs. lookupStatus is not_found for a deleted or missing id, so branch on it before reading photo.

Flickr Photo API FAQ

How do I find the photo id?

It is the digits in the photo URL, for example 2362225867 in /photos/bees/2362225867. Short links and full URLs are not accepted here, so copy the numeric id.

Does it return the photo file?

No. It returns the URLs of every size the photo record lists, in sizes[].url. The image itself stays on its own host and is never fetched by Social Fetch.

How much does a photo 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 lookupStatus mean?

found means the photo was returned. not_found means it does not exist or was deleted. HTTP 200 only means the request finished, so always branch on lookupStatus.

Why are some fields null?

The public photo record omits keys for some photos, for example when the owner hides a description. Missing values are null rather than guessed. Licence names and URLs are filled for ids 0 to 16; an id outside that range keeps a null name and URL.

Other Flickr endpoints