List Facebook profile posts
Lists public posts for a Facebook profile or page identified by `url` or `pageId`, with cursor-based pagination. Private profiles, missing pages, and profiles with no public posts can all surface as HTTP `200` with an empty `data.posts` page—this route does not expose `lookupStatus`. Call `GET /v1/facebook/profiles` first when you need explicit `found` / `private` / `not_found` before interpreting an empty list.
Operation
/v1/facebook/profiles/postsHeaders
API key (`sfk_...`)
Parameters
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
Response fields
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
Responses
Facebook posts for the requested profile or page. Empty `data.posts` is ambiguous without a profile preflight—see the operation description.
Error codes
Profile
Looks up a Facebook public profile or page by full URL. Outcomes such as found, private, or not found are indicated in `data.lookupStatus`.
Profile reels
Lists public Facebook reels 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.