Get Facebook post or reel
Returns public metadata for a single Facebook post or reel URL. Availability is indicated in `data.lookupStatus` as `found` or `not_found`. Optional `includeComments` and `includeTranscript` request extra fields when available.
Operation
/v1/facebook/postsHeaders
API key (`sfk_...`)
Parameters
Public permalink to the Facebook post or reel.
min 1 chars · max 4096 chars
When true, includes a sample of top-level comments when available.
When true, includes a plain-text transcript when available for the video.
Response fields
Endpoint-specific response payload.
Whether the URL could be resolved to public content.
one of: found, not_found
Post details when found.
Social platform for this content.
one of: facebook
Platform post id when available.
min 1 chars
Canonical or resolved public URL for this post or reel.
min 1 chars
Caption or body text when available.
Publication timestamp in ISO 8601 when available.
Opaque feedback identifier when exposed by the platform; may be used for related lookups.
Author when found.
Display name of the author.
min 1 chars
Public profile URL for the author when available.
min 1 chars
Avatar image URL when available.
Platform-specific author id when available.
Whether the author is marked as verified.
Engagement metrics for the post or reel.
Like count when available.
≥ 0
Comment count when available.
≥ 0
Share count when available.
≥ 0
View or play count when available.
≥ 0
Primary media for the post or reel.
Thumbnail image URL when available.
Primary image URL when the post is image-based.
Standard-definition video URL when available.
High-definition video URL when available.
Video duration in seconds when available.
≥ 0
Video width in pixels when available.
≥ 0
Video height in pixels when available.
≥ 0
Caption or subtitle asset URL when available.
Attached audio metadata when available.
Track title when the post uses attached audio.
Album art image URL when available.
Audio track id when available.
Audio source type label when available.
Sample of top-level comments when requested and available.
Stable id for the comment when available.
min 1 chars
Comment body text.
Creation timestamp in ISO 8601 when available.
Number of direct replies when available.
≥ 0
Total reactions when available.
≥ 0
Display name of the commenter.
min 1 chars
Plain-text transcript when requested and 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
Post or reel metadata (found or not found in body).
Error codes
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.
Post comments
Lists top-level comments for a public Facebook post or reel URL with optional cursor-based pagination.