Social platforms

Get the transcript of a Facebook video post · Facebook API

GET/facebook/posts/transcript

$min $0.003

Returns the spoken-word transcript of a public Facebook video post or Reel by URL, for videos up to a few minutes long. Returns `not_found` when the post does not exist.

Add to Claude Read the docs

Using ChatGPT, Claude Code or another client? See the setup steps

Request

curl https://api.unifapi.com/facebook/posts/transcript?url= \
  -H "Authorization: Bearer $UNIFAPI_KEY"

Parameters

urlqueryrequired: Link to the Facebook post or reel whose transcript should be returned.
: The parameter for this Facebook operation. Use the URL-visible slug or id described in the docs.

Overview

This operation is part of the Facebook API in the social platforms category. It uses the same Bearer token, request tracing, error model, and billing envelope as every UnifAPI endpoint, so agents can switch between platforms without custom per-vendor glue code.

Use it when a workflow needs Facebook public data alongside other social networks, but should still keep one API key, one account balance, and one predictable JSON contract.

Common agent workflows

Fetch canonical public Facebook content for summarization, ranking, monitoring, or enrichment.
Attach engagement, author, media, and source metadata to an agent workflow.
Give an AI agent a stable Facebook data source without building a per-platform integration.
Normalize Facebook responses into the same UnifAPI envelope used across the catalog.

Response shape

Unified envelope, platform-native fields

Lookup responses return one canonical object in `data` with stable identifiers, source URLs where available, and platform-specific metadata normalized into predictable JSON.
The operation has a 3 credits ($0.003) minimum charge, so `billing.records_charged` can be higher than the visible records returned.
A not-found or invalid-input condition uses the unified UnifAPI error shape, so callers do not need special handling for each source platform.

Response status codes

200400401402404429500502503

Billing

This operation charges 1 credit per billable record, with a 3 credits ($0.003) operation minimum. Public responses include billing metadata with credits charged, records charged, and remaining workspace balance. Incorrect Credit deductions caused by platform failures can be restored as billing corrections.

Errors and retries

Authentication, validation, rate-limit, not-found, and provider errors use the unified UnifAPI error format. Agents should log `request_id`, retry only retryable failures, and treat invalid API keys, disabled keys, and expired keys as the same public `unauthorized` error type.

Response fields

Fields in the data object

A successful Get the transcript of a Facebook video post call returns one data object with these fields.

urlstring | null: Public URL of the Facebook post or reel that was requested (same as the lookup input).
transcriptstring | null: Plain transcript text when available. May be null when speech is not detected, the video exceeds supported length, or transcription is otherwise unavailable.

Related endpoints

More Facebook operations

Combine endpoints from the same platform, then join the results with other UnifAPI categories without changing authentication or response parsing.

GET/facebook/posts/comments/replies

List replies to a Facebook comment

Returns replies to one Facebook comment. Pass the comment's `replies_cursor` as `cursor`, then each response's `pagination.next_cursor` for the next page.

GET/facebook/profiles/{username}

Get a Facebook profile or Page

Returns a public Facebook profile or Page by username: name, category, intro, follower and like counts, contact details and business information. Returns `not_found` when it does not exist or is not public.

GET/facebook/posts

Get a Facebook post or Reel by URL

Returns one public Facebook post or Reel by its URL: author, text, media, music and reaction, comment and share counts. Set `include_comments` or `include_transcript` for a comment sample or a video transcript. Returns `not_found` when the post does not exist or is not public.

GET/facebook/posts/comments