Social Fetch
Facebook

Get Facebook post transcript

Returns a plain-text transcript for a public Facebook post or reel when available. Pass `url` as a full permalink. Short videos are more likely to return speech; longer videos may not include a transcript. Inspect `data.lookupStatus` for found, not found, or lookup_failed.

Operation

GET/v1/facebook/posts/transcript
Cost: 1 credit

Headers

x-api-keystringrequired(header)

API key (`sfk_...`)

Parameters

urlstringrequired(query)

Link to the Facebook post or reel whose transcript should be returned.

min 1 chars · max 4096 chars

Response fields

data
objectrequired

Endpoint-specific response payload.

datalookupStatus
stringrequired

Outcome of the transcript lookup: transcript resolved, not found, or lookup could not be completed.

one of: found, not_found, lookup_failed

datapost
objectrequirednullable

Post or reel identity when the lookup resolved; otherwise null.

dataposturl
stringrequired

Public URL of the Facebook post or reel that was requested (same as the lookup input).

min 1 chars

datatranscript
stringrequirednullable

Plain transcript text when available. May be null when speech is not detected, the video exceeds supported length, or transcription is otherwise unavailable.

meta
objectrequired

Metadata describing the request and billing outcome.

metarequestId
stringrequired

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integerrequired

Credits charged for this request.

≥ 0

metaversion
stringrequired

Public API version that served the response.

one of: v1

Code example

Responses

Transcript lookup result. Inspect `data.lookupStatus` for found, not found, or lookup_failed.

Error codes

insufficient_creditsinternal_errorlookup_failedtemporarily_unavailableunauthorized

On this page