Social Fetch
Reddit

Get Reddit post transcript

Get captions transcript for a Reddit video post.

Accepts Reddit post permalinks and direct hosted video URLs.

When the post resolves but captions are unavailable, `data.transcript` is null while `data.lookupStatus` is `found`.

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

API key (`sfk_...`)

Parameters
2
url*stringquery

Link to the Reddit post or direct hosted video URL whose transcript should be returned.

min 1 chars · max 4096 chars

languagestringoptionalquery

Optional ISO 639-1 language code (two letters) to prefer when multiple caption tracks exist.

min 2 chars · max 2 chars

Response fields
17

Endpoint-specific response payload.

datalookupStatus
string

Outcome of the transcript lookup.

one of: found, not_found, lookup_failed

Post identity when the lookup resolved; otherwise null.

datapostid
string

Stable post identifier.

min 1 chars

dataposturl
string

Canonical public post URL.

min 1 chars

datapostvideoId
stringnullable

Hosted video identifier when available.

Transcript content when captions are available. Null when the post resolved but captions are not exposed.

datatranscriptplainText
string

Full transcript text parsed from captions.

datatranscriptlanguage
string

ISO 639-1 language code for the caption track when reported by the lookup.

Timed transcript segments parsed from captions.

datatranscriptsegments[]text
string

Transcript segment text.

datatranscriptsegments[]startMs
integer

Segment start offset in milliseconds.

≥ 0

datatranscriptsegments[]endMs
integer

Segment end offset in milliseconds.

≥ 0

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/reddit/posts/transcript?url=https://www.reddit.com/r/youseeingthisshit/comments/1oiu9xm/football_nostalgiasaints_punter_head_coach_cant/" \
  -H "x-api-key: YOUR_API_KEY"

Responses

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

On this page

No Headings