> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/flickr/photos-photoid>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/flickr/photos-photoid.mdx>

---

# Flickr Photo API

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

`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`.

## Request

- **Endpoint:** `GET /v1/flickr/photos/{photoId}`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by photo id
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/flickr/photos/photoid/get)
- **Platform page:** [/platforms/flickr](https://www.socialfetch.dev/platforms/flickr)

## 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.