X Transcript API

X Transcript API —
video tweets to JSON.

Q: Which X URLs does the API accept?

Public video tweets at x.com/<user>/status/<id> or the equivalent twitter.com/<user>/status/<id>. Both domains point at the same tweet.

Q: Is there a length limit?

Yes — the video must be under 2 minutes. Most video tweets are well within this limit. Longer videos are rejected.

POST a video tweet URL and get back an AI-generated JSON transcript. Works with x.com and twitter.com /status/ links; video must be under 2 minutes. Example: https://x.com/TheoVon/status/1916982720317821050

POST /api/twitter/transcript

Get your API key Read the full reference →

JSON response Cache hits are free 1 credit per call No scraping

Supported

What the API handles.

Every X URL format below resolves to the same JSON response shape — no branching logic needed in your client code.

Video tweets

Public tweets containing a video at x.com/<user>/status/<id>. The transcript is generated with AI from the clip’s audio.

x.com & twitter.com

Both domains resolve to the same tweet, so either x.com/…/status/… or twitter.com/…/status/… works.

Under 2 minutes

The video must be under 2 minutes. Most video tweets fall well within this limit; longer clips are rejected.

AI-generated

Because transcripts are AI-generated rather than caption-based, responses can be slightly slower — but they work even when the clip has no captions.

Reference

Full docs at docs.transcriptmagic.com.

Per-platform response schemas, language-specific code samples (cURL, Python, JavaScript, Go, PHP), error catalog, and rate-limit headers all live on the docs subdomain. Built for both humans and agents.

X reference → Endpoint shape, accepted URL formats, response fields, examples. Quickstart → Make your first call in under five minutes. Authentication → Bearer tokens, key rotation, revocation. Errors → Status codes, retry strategy, common pitfalls.

Pricing

One credit per call.

Every successful API request uses 1 credit. X video transcription requires the clip to be under 2 minutes. View the full plan breakdown and annual pricing on the pricing page.

Plans · credits · rollover

See pricing

Use cases

What devs build with it.

Real pipelines shipping real revenue. If you're doing something new, email us — we love hearing what teams are building.

Social listening

Transcribe video tweets at scale to track how people talk about your brand, product, or category.

Content repurposing

Turn a video tweet into a thread, blog draft, or newsletter automatically inside a content workflow.

Monitoring & alerts

Pipe transcripts into keyword monitors so a clip mentioning your terms triggers an alert.

Research datasets

Build a searchable corpus of spoken content from video tweets for analysis.

Quote extraction

Surface exact quotes from a viral clip for accurate citation in articles.

Accessibility workflows

Generate text alternatives for video tweets as part of an internal accessibility process.

FAQ

Questions devs ask.

The short answers. For anything else, email [email protected] — same-day reply.

Which X URLs does the API accept?

Public video tweets at x.com/<user>/status/<id> or the equivalent twitter.com/<user>/status/<id>. Both domains point at the same tweet.

Is there a length limit?

Yes — the video must be under 2 minutes. Most video tweets are well within this limit. Longer videos are rejected.

Why can X requests be slightly slower?

X transcripts are AI-generated rather than pulled from existing captions, so processing can take a little longer. The upside is that it works even on clips with no captions.

Do x.com and twitter.com both work?

Yes. Either domain resolves to the same tweet, so you can POST either form of the /status/ URL.

How is each call billed?

Every successful call is 1 credit. Cache hits and error responses are free.

Does the response include a video download URL?

When available, a download URL is included; the field is omitted when the upstream doesn't expose a downloadable URL.

Ship your X pipeline — today.

Free credits included. No credit card required. Same auth across every platform endpoint.

Get your API key Read the docs

X Transcript API — video tweets to JSON.