List Facebook profile photos
List photos from a Facebook profile or Page.
Headers
Get your API keyAPI key (`sfk_...`)
Public Facebook profile or page URL whose photos should be listed.
min 1 chars · max 4096 chars
Opaque pagination cursor from a previous response.
min 1 chars · max 4096 chars
When true, hosts source media for 90 days and returns delivery URLs in each photo's `hostedMedia`.
Endpoint-specific response payload.
Whether the requested profile or page resolved for this request.
one of: found, not_found
Photos returned for the requested profile or page. This array may be empty on the last page.
Stable photo item identifier from Facebook.
min 1 chars
Facebook photo id when available.
min 1 chars
Public Facebook URL for this photo.
min 1 chars
Accessibility or alt-style caption text when Facebook provides one.
Source-platform CDN URL for the primary image when available. It can expire or be rejected outside the original retrieval context; it is not a SocialFetch-hosted asset. Null when no syntactically usable URL is available. For durable hosted copies on this list route, pass `hostMedia=true`.
Source-platform CDN URL for the thumbnail when available. It can expire or be rejected outside the original retrieval context; it is not a SocialFetch-hosted asset. Null when no syntactically usable URL is available. For durable hosted copies on this list route, pass `hostMedia=true`.
Image dimensions when available.
Image width in pixels when available.
≥ 0
Image height in pixels when available.
≥ 0
Present only when `hostMedia=true`. Hosted copies and/or per-asset failures for this photo.
Whether SocialFetch stored a durable copy of this asset.
one of: stored, failed
Normalized media kind.
one of: image, video
Which source field this asset was derived from.
one of: display, thumbnail, video
Source-platform CDN URL that was requested for hosting. Still transient; prefer `url` when status is stored.
Time-limited SocialFetch delivery URL when status is stored. Re-request hostMedia (or a future refresh route) before this expires if you still need access; object retention may outlive the delivery URL.
ISO-8601 timestamp when the returned delivery URL stops working.
ISO-8601 timestamp when the stored object is deleted from SocialFetch storage (90-day tier).
MIME type of the stored bytes when status is stored.
min 1 chars
Stored size in bytes when status is stored.
≥ 0
Pixel width when known.
≥ 0
Pixel height when known.
≥ 0
Opaque parent entity id for this asset (post, reel, photo, or video id).
min 1 chars
Legacy Instagram media id alias for `entityId`. Prefer `entityId`.
min 1 chars
Typed failure code when status is failed.
min 1 chars
Short customer-safe failure message when status is failed.
min 1 chars
Pagination information for the current response.
Cursor to pass as `cursor` in the next request when `hasMore` is true; otherwise null.
Whether another page of photos can be requested.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.
Code example
curl "https://api.socialfetch.dev/v1/facebook/profiles/photos?url=https://www.facebook.com/profile.php?id=61575098504636" \
-H "x-api-key: YOUR_API_KEY"Responses
Facebook photos for the requested profile or page.