Social Fetch
Facebook

Get Facebook post or reel

Get a Facebook post or Reel.

GET/v1/facebook/posts
1credit
x-api-key*stringheader

API key (`sfk_...`)

Parameters
3
url*stringquery

Public permalink to the Facebook post or reel.

min 1 chars · max 4096 chars

includeCommentsbooleanoptionalquery

When true, includes a sample of top-level comments when available.

includeTranscriptbooleanoptionalquery

When true, includes a plain-text transcript when available for the video.

Response fields
50

Endpoint-specific response payload.

datalookupStatus
string

Whether the URL could be resolved to public content.

one of: found, not_found

Post details when found.

datapostplatform
string

Social platform for this content.

one of: facebook

datapostpostId
string

Platform post id when available.

min 1 chars

dataposturl
string

Canonical or resolved public URL for this post or reel.

min 1 chars

datapostdescription
stringnullable

Caption or body text when available.

datapostpublishedAt
stringnullable

Publication timestamp in ISO 8601 when available.

datapostfeedbackId
stringnullable

Opaque feedback identifier when exposed by the platform; may be used for related lookups.

Author when found.

dataauthorname
string

Display name of the author.

min 1 chars

dataauthorprofileUrl
stringnullable

Public profile URL for the author when available; null when not exposed (e.g. some group posts).

min 1 chars

dataauthoravatarUrl
stringnullable

Avatar image URL when available.

dataauthorplatformUserId
stringoptional

Platform-specific author id when available.

dataauthorverified
boolean

Whether the author is marked as verified.

Engagement metrics for the post or reel.

datametricslikes
integernullable

Like count when available.

≥ 0

datametricscomments
integernullable

Comment count when available.

≥ 0

datametricsshares
integernullable

Share count when available.

≥ 0

datametricsviews
integernullable

View or play count when available.

≥ 0

datametricsreactions
objectnullable

Per-category reaction totals for the post when exposed by the platform.

Primary media for the post or reel.

datamediathumbnailUrl
stringnullable

Thumbnail image URL when available.

datamediaimageUrl
stringnullable

Primary image URL when the post is image-based.

datamediavideoUrl
stringnullable

Standard-definition video URL when available.

datamediavideoHdUrl
stringnullable

High-definition video URL when available.

datamediadurationSec
numbernullable

Video duration in seconds when available.

≥ 0

datamediawidth
integernullable

Video width in pixels when available.

≥ 0

datamediaheight
integernullable

Video height in pixels when available.

≥ 0

datamediacaptionsUrl
stringnullable

Caption or subtitle asset URL when available.

Attached audio metadata when available.

datamusictrackTitle
stringnullable

Track title when the post uses attached audio.

datamusicalbumArtUrl
stringnullable

Album art image URL when available.

datamusicmusicId
stringoptional

Audio track id when available.

datamusictype
stringoptional

Audio source type label when available.

Sample of top-level comments when requested and available.

datacomments[]commentId
string

Stable id for the comment when available.

min 1 chars

datacomments[]text
stringnullable

Comment body text.

datacomments[]createdAt
stringnullable

Creation timestamp in ISO 8601 when available.

datacomments[]replyCount
integer

Number of direct replies when available.

≥ 0

datacomments[]reactionCount
integer

Total reactions when available.

≥ 0

datacomments[]authorName
string

Display name of the commenter.

min 1 chars

datacomments[]authorPlatformUserId
stringoptional

Platform-specific id for the commenter when available.

datacomments[]authorAvatarUrl
stringnullable

Avatar image URL for the commenter when available.

datacomments[]reactions
objectnullable

Per-category reaction totals on the comment when exposed by the platform.

datatranscript
stringnullable

Plain-text transcript when requested and available.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/facebook/posts?url=https://www.facebook.com/profile.php?id=61575098504636" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Post or reel metadata (found or not found in body).

On this page

No Headings