Flickr

List Flickr Explore photos

List a day of Flickr Explore photos.

GET/v1/flickr/explore
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
4
cursorstringquery

Cursor from `page.nextCursor` of the previous response. It only works with the same filters. Send it without `page`; it keeps the page size it was issued with, so `limit` may be sent again and has no effect.

min 1 chars · max 2048 chars

pageintegerquery

Page number, 1-based. Default: 1. A page past the last returns an empty list with `hasMore: false`. Prefer `cursor` when continuing.

≥ 1 · ≤ 1000000

limitintegerquery

Rows per page, 1 to 100. Default: 100.

≥ 1 · ≤ 100

datestringquery

Day, `YYYY-MM-DD`. Explore began in 2004; earlier days are empty. Default: the latest published day, which is yesterday (UTC) once its list is out and the day before until then.

Response fields
117

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

datadate
string

The day of this result. When no `date` was sent, the latest published day.

Photos on this page.

dataphotos[]id
string

Photo id.

dataphotos[]url
stringnullable

Photo page URL.

dataphotos[]shortUrl
stringnullable

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

dataphotos[]title
stringnullable

Title.

dataphotos[]description
stringnullable

Description as HTML, as the owner wrote it.

dataphotos[]mediaType
stringnullable

`photo` or `video`.

dataphotos[]mediaStatus
stringnullable

Processing state, e.g. `ready`.

dataphotos[]contentType
integernullable

1 photo, 2 screenshot or other.

dataphotos[]safetyLevel
integernullable

0 safe, 1 moderate, 2 restricted.

The photo's licence.

dataphotos[]licenseid
integernullable

Licence id, 0 to 16.

dataphotos[]licensename
stringnullable

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

dataphotos[]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.

dataphotos[]ownerid
stringnullable

NSID.

dataphotos[]owneralias
stringnullable

Path alias used in URLs.

dataphotos[]ownername
stringnullable

Display name, with bidi controls removed.

dataphotos[]ownerrealName
stringnullable

Real name the person chose to show.

dataphotos[]ownerlocation
stringnullable

Location the person chose to show.

dataphotos[]ownerisPro
booleannullable

Whether the account is Pro.

dataphotos[]ownerproTier
stringnullable

Pro badge, `standard` or `legacy`.

dataphotos[]ownercreatedAt
stringnullable

Account creation time, ISO 8601 UTC.

The person's avatar at three sizes.

dataphotos[]owneravatarsmall
stringnullable

Square avatar URL, 100 pixels.

dataphotos[]owneravatarmedium
stringnullable

Avatar URL, 240 pixels.

dataphotos[]owneravatarlarge
stringnullable

Avatar URL, 500 pixels.

dataphotos[]ownerprofileUrl
stringnullable

Profile page URL.

dataphotos[]ownerphotosUrl
stringnullable

Photostream URL.

Dates attached to a photo.

dataphotos[]datestakenAt
stringnullable

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

dataphotos[]datestakenGranularity
integernullable

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

dataphotos[]datestakenUnknown
booleannullable

Whether the owner marked the date unknown.

dataphotos[]datespostedAt
stringnullable

Upload time, ISO 8601 UTC.

dataphotos[]dateslastUpdateAt
stringnullable

Last metadata change, ISO 8601 UTC.

dataphotos[]datesaddedAt
stringnullable

Time added to a pool, ISO 8601 UTC.

dataphotos[]datesfavoritedAt
stringnullable

Time favourited, ISO 8601 UTC.

Counts attached to a photo.

dataphotos[]countsviews
integernullable

Views.

dataphotos[]countsfavorites
integernullable

Times favourited.

dataphotos[]countscomments
integernullable

Comments.

dataphotos[]countsnotes
integernullable

Notes.

Original dimensions; null when not shown.

Size of the original file.

dataphotos[]dimensionsoriginalwidth
integernullable

Original width.

dataphotos[]dimensionsoriginalheight
integernullable

Original height.

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

dataphotos[]sizes[]key
string

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

dataphotos[]sizes[]label
stringnullable

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

dataphotos[]sizes[]url
stringnullable

Image URL.

dataphotos[]sizes[]width
integernullable

Width in pixels.

dataphotos[]sizes[]height
integernullable

Height in pixels.

dataphotos[]sizes[]media
stringnullable

`photo` or `video`.

Tags.

dataphotos[]tags[]
stringoptional

Where the photo was taken.

dataphotos[]geolatitude
numbernullable

Latitude.

dataphotos[]geolongitude
numbernullable

Longitude.

dataphotos[]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.

dataphotos[]geoplaceneighbourhoodname
stringnullable

Place name.

dataphotos[]geoplaceneighbourhoodwoeId
stringnullable

WOE id.

One level of the place hierarchy.

dataphotos[]geoplacelocalityname
stringnullable

Place name.

dataphotos[]geoplacelocalitywoeId
stringnullable

WOE id.

One level of the place hierarchy.

dataphotos[]geoplacecountyname
stringnullable

Place name.

dataphotos[]geoplacecountywoeId
stringnullable

WOE id.

One level of the place hierarchy.

dataphotos[]geoplaceregionname
stringnullable

Place name.

dataphotos[]geoplaceregionwoeId
stringnullable

WOE id.

One level of the place hierarchy.

dataphotos[]geoplacecountryname
stringnullable

Place name.

dataphotos[]geoplacecountrywoeId
stringnullable

WOE id.

Always null: photo locations do not name a venue.

dataphotos[]geoplacevenuename
stringnullable

Venue name.

dataphotos[]geoplacevenuewoeId
stringnullable

WOE id.

dataphotos[]geoplacevenuefoursquareId
stringnullable

Foursquare venue id.

Notes placed on the photo.

dataphotos[]notes[]id
stringnullable

Note id.

dataphotos[]notes[]photoId
stringnullable

Photo the note is on.

dataphotos[]notes[]author
stringnullable

Author NSID.

dataphotos[]notes[]authorName
stringnullable

Author display name.

dataphotos[]notes[]authorRealName
stringnullable

Author real name.

dataphotos[]notes[]authorIsPro
booleannullable

Whether the author is Pro.

dataphotos[]notes[]authorIsDeleted
booleannullable

Whether the author's account is deleted.

dataphotos[]notes[]x
integernullable

Left position in pixels.

dataphotos[]notes[]y
integernullable

Top position in pixels.

dataphotos[]notes[]width
integernullable

Width in pixels.

dataphotos[]notes[]height
integernullable

Height in pixels.

dataphotos[]notes[]text
stringnullable

Note text.

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

dataphotos[]videoready
integernullable

1 when the video is ready.

dataphotos[]videofailed
integernullable

1 when processing failed.

dataphotos[]videopending
integernullable

1 while processing.

dataphotos[]videodurationSeconds
integernullable

Length in seconds.

dataphotos[]videowidth
integernullable

Playback width.

dataphotos[]videoheight
integernullable

Playback height.

dataphotos[]originalFormat
stringnullable

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

dataphotos[]rotation
integernullable

Rotation the owner set.

dataphotos[]isPublic
booleannullable

Whether the photo is public.

Pagination state for the current page.

datapagepage
integer

Current page number.

≥ 0

datapagehasMore
boolean

Whether another page is available.

datapagenextPage
integernullable

Next page number; null on the last page.

≥ 0

datapagenextCursor
stringnullable

Cursor for the next page; null on the last page.

datapagetotalItems
integernullable

Total rows in the whole list; null when no usable total is available, including a page past the end and a photo search with a taken time bound. It can change between calls.

datapagereachableItems
integernullable

Rows this endpoint can reach. Smaller than `totalItems` where this endpoint stops early. Null when `totalItems` is null.

datapagelimit
integer

Rows requested for this page.

≥ 0

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

Code example

curl "https://api.socialfetch.dev/v1/flickr/explore?date=2026-11-01" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Flickr explore.