Social Fetch
Facebook

List Facebook profile photos

Lists public Facebook photos for a profile or page URL. Check `data.lookupStatus` for `found` vs `not_found`. Use `data.page.nextCursor` to request the next page when `data.page.hasMore` is true.

Operation

GET/v1/facebook/profiles/photos

Headers

x-api-keystringrequired(header)

API key (`sfk_...`)

Parameters

urlstringrequired(query)

Public Facebook profile or page URL whose photos should be listed.

min 1 chars · max 4096 chars

cursorstring(query)

Opaque pagination cursor from a previous response (`data.page.nextCursor`).

min 1 chars · max 4096 chars

Response fields

data
objectrequired

Endpoint-specific response payload.

datalookupStatus
stringrequired

Whether the requested profile or page resolved for this request.

one of: found, not_found

dataphotos
arrayrequired

Photos returned for the requested profile or page. This array may be empty on the last page.

dataphotos[]id
stringrequired

Stable photo item identifier from Facebook.

min 1 chars

dataphotos[]photoId
stringrequired

Facebook photo id when available.

min 1 chars

dataphotos[]url
stringrequired

Public Facebook URL for this photo.

min 1 chars

dataphotos[]accessibilityCaption
stringrequirednullable

Accessibility or alt-style caption text when Facebook provides one.

dataphotos[]imageUrl
stringrequirednullable

Primary image URL when available.

dataphotos[]thumbnailUrl
stringrequirednullable

Thumbnail image URL when available.

dataphotos[]dimensions
objectrequirednullable

Image dimensions when available.

dataphotos[]dimensionswidth
integerrequired

Image width in pixels when available.

≥ 0

dataphotos[]dimensionsheight
integerrequired

Image height in pixels when available.

≥ 0

datapage
objectrequired

Pagination information for the current response.

datapagenextCursor
stringrequirednullable

Cursor to pass as `cursor` in the next request when `hasMore` is true; otherwise null.

datapagehasMore
booleanrequired

Whether another page of photos can be requested.

meta
objectrequired

Metadata describing the request and billing outcome.

metarequestId
stringrequired

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integerrequired

Credits charged for this request.

≥ 0

metaversion
stringrequired

Public API version that served the response.

one of: v1

Code example

Responses

Facebook photos for the requested profile or page. Check `data.lookupStatus` for `found` vs `not_found`.

Error codes

bad_requestinsufficient_creditsinternal_errorlookup_failedtemporarily_unavailableunauthorized

On this page