List Facebook profile posts
List posts from a Facebook profile or Page.
Headers
Get your API keyAPI key (`sfk_...`)
Full public Facebook profile or page URL.
min 1 chars · max 4096 chars
Facebook page or profile id when you have it instead of a full URL.
min 1 chars · max 4096 chars
Opaque pagination cursor from a previous response.
min 1 chars
When true, hosts source media for 90 days and returns delivery URLs in each post's `hostedMedia`.
Endpoint-specific response payload.
Whether the requested profile or page resolved for this request.
one of: found, not_found
Facebook posts for the requested input. May be empty when `lookupStatus` is `found` and no public posts are returned, or when `lookupStatus` is `not_found`.
Facebook post id.
min 1 chars
Post caption or text when present.
Public Facebook URL for this post.
min 1 chars
When the post was published (ISO-8601) when available.
Display name for the post author when available.
Short display label for the author when Facebook provides one.
Facebook id for the post author when available.
Reaction count when available.
≥ 0
Comment count when available.
≥ 0
Video view count when available.
≥ 0
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. Omitted when no syntactically usable URL is available. For durable hosted copies on this list route, pass `hostMedia=true`.
Source-platform CDN gallery image URLs when the post includes multiple images. Each URL can expire or be rejected outside the original retrieval context; they are not SocialFetch-hosted assets. For durable hosted copies on this list route, pass `hostMedia=true`.
min 1 chars
Source-platform CDN URL for standard-definition video when available. It can expire or be rejected outside the original retrieval context; it is not a SocialFetch-hosted asset. For durable hosted copies on this list route, pass `hostMedia=true` (HD is preferred when both are present).
Source-platform CDN URL for high-definition video when available. It can expire or be rejected outside the original retrieval context; it is not a SocialFetch-hosted asset. For durable hosted copies on this list route, pass `hostMedia=true`.
Source-platform CDN URL for the video thumbnail when available. It can expire or be rejected outside the original retrieval context; it is not a SocialFetch-hosted asset. For durable hosted copies on this list route, pass `hostMedia=true`.
A small set of top comments when Facebook exposes them for the post.
Comment id.
min 1 chars
Comment text when available.
When the comment was published (ISO-8601) when available.
Display name for the comment author when available.
Facebook id for the comment author when available.
Public Facebook URL for the comment author when available.
Present only when `hostMedia=true`. Hosted copies and/or per-asset failures for this post.
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 state for the current response.
Cursor to pass as `cursor` in the next request when more posts are available.
Whether another page of posts is available.
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/posts?url=https://www.facebook.com/profile.php?id=61575098504636" \
-H "x-api-key: YOUR_API_KEY"Responses
Facebook posts for the requested profile or page. Check `data.lookupStatus` when `posts` is empty.