List Facebook profile posts
Get posts from a Facebook profile or page.
Call `GET /v1/facebook/profiles` first when you need `found` / `private` / `not_found` before interpreting an empty posts page.
An empty `data.posts` page with `hasMore: false` can represent no public posts, restricted visibility, or an unresolvable URL or id—there is no `lookupStatus` field on this route.
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 (`data.page.nextCursor`).
min 1 chars
Endpoint-specific response payload.
Facebook posts for the requested input. An empty array can mean no public posts were returned, the profile does not expose posts publicly, or the URL or id could not be resolved—there is no separate lookup status on this route.
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 (Unix epoch seconds) 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
Primary image URL when the post includes a single primary image.
Gallery image URLs when the post includes multiple images.
min 1 chars
Standard-definition video URL when this post includes playable video.
High-definition video URL when this post includes playable video.
Video thumbnail image URL when available.
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 (Unix epoch seconds) 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.
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
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. Empty `data.posts` is ambiguous without a profile preflight—see the operation description.