Get Twitter tweet transcript

Get the transcript for a video tweet.

For video tweets only. Responses can take longer than typical lookups. Videos longer than about two minutes cannot be transcribed.

Try in Playground

GET/v1/twitter/tweets/transcript

1credit

Headers

Get your API key

x-api-key*stringheader

API key (`sfk_...`)

Parameters

url*stringquery

Tweet permalink or identifier.

min 1 chars · max 4096 chars

Response fields

Endpoint-specific response payload.

datalookupStatus

string

Outcome of the transcript lookup.

one of: found, not_found, lookup_failed

Tweet identity when the lookup resolved; otherwise null.

datatweeturl

string

Public URL of the tweet that was requested (same as the lookup input).

min 1 chars

datatranscript

stringnullable

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

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/twitter/tweets/transcript?url=https://x.com/TheoVon/status/1916982720317821050" \
  -H "x-api-key: YOUR_API_KEY"

Responses

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

Get Twitter tweet transcript

Headers

Code example

Responses

On this page