Skip to main content
Public video tweets are supported. Both x.com and twitter.com /status/ URLs work. The video must be under 2 minutes — X tweets are AI-transcribed, so this endpoint is slower than the others.

Request

Response

transcript is a plain string with newlines between spoken lines — there is no per-line timing in the X response and no videoUrls field.

Supported URL formats

Both the x.com and legacy twitter.com domains are accepted as long as the URL points at a /status/{id} tweet. URLs without a /status/ path are rejected with 400 Invalid URL.

FAQ

Yes. Both the x.com and the legacy twitter.com /status/ URLs are accepted.
Yes — the video must be under 2 minutes. Longer videos can’t be transcribed by this endpoint.
X tweets don’t ship with captions, so the video is AI-transcribed on demand. That takes longer than the caption-based endpoints — expect a longer round trip, especially near the 2-minute limit.
Only tweets that contain a video. Text, image, and link tweets have nothing to transcribe and are rejected.
No. X transcripts are returned as plain text with newlines between lines — there is no per-line timing.