x/
post-transcript

The Twitter Video Transcript API transcribes the speech in X videos from the URLs of their posts, returning the spoken words as plain text with each video's duration in seconds, several posts per request.

Twitter Video Transcript API

Post URL input
Plain-text transcript
Duration in seconds
0.7 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

Twitter Video Transcript

Videos on X, formerly Twitter, carry interviews, announcements, product demos and commentary in their spoken audio, which a transcript turns into plain text paired with the clip's length in seconds. Written out, that speech can be quoted exactly, summarised, translated and searched with the same keyword and topic methods used on written posts.

Twitter Video Transcript API Features

  • Video posts by URLPass one or more x.com/{username}/status/{post_id} links to tweets with a video into the Twitter Video Transcript API, and each video returns one row carrying its post id and url.
  • Speech as continuous plain texttext holds the words spoken in the video as one block of plain text, with format set to "text", written in the language the speaker used.
  • Video length with each transcriptduration_seconds gives the running time of the video, useful for sorting clips by length and for measuring how densely a video is spoken.

Twitter Video Transcript API Parameters

ParametersRequiredDescription
urlsRequiredOne or more X post URLs in the /{username}/status/{post_id} form, each pointing to a post that contains a video.

How to Use the Twitter Video Transcript API

Submit the URLs of video posts to the Twitter Video Transcript API and read one transcript per video.

  1. POST {"urls": ["https://x.com/NASA/status/2119833829389041896"]} to /v1/x/post-transcript.
  2. Poll GET /v1/tasks/{task_id}; transcripts are ready once status is succeeded.
  3. Read each transcript from results.items, and when has_more is true, fetch the rest with results.next_cursor.
curl -X POST "https://api.socq.ai/v1/x/post-transcript" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/NASA/status/2119833829389041896"]}'

# Videos up to 2 minutes cost 0.7 credits; longer ones cost 4 credits per started minute.

Twitter Video Transcript API Use Cases

  • Quoting what was said in a clip: Copy exact sentences from text and cite the post url, so a quote from an interview or press clip can be checked against its source.
  • Summarising and translating video posts: Send text to a summariser or translation model to turn long video posts into short notes or into other languages.
  • Searching spoken content across many videos: Index the transcripts of a creator's or brand's video posts to find every clip that mentions a product, person or topic.
  • Publishing a text version of a video: Place text beneath the video in articles, newsletters or help pages so readers can follow it with the sound off.

Twitter Video Transcript API Pro Tips

  • Budget long recordings separately: a video up to 2 minutes costs 0.7 credits, while a 10-minute recording costs 40, charged for every started minute of its full length.
  • Detect the language of text before routing it to translation, since each transcript is written in the language spoken in the video.
  • Submit mixed lists of post URLs to the Twitter Video Transcript API when you are unsure which posts hold a video; video posts return transcripts and the rest cost nothing, while a list made up only of text or image posts fails with a full refund.

Beyond the Twitter Video Transcript API, use these APIs when you need a different type of public X data.

  • Twitter Tweet Scraper API — Retrieve public post text, authors, engagement, media, hashtags, mentions, and conversation relationships from x.com or twitter.com status URLs.
  • Twitter User Tweets Scraper API — Collect recent public posts, authors, media, hashtags, mentions, and engagement by username with replies excluded.
  • X Post Quotes API — Collect public quote posts for known status URLs with commentary, authors, engagement, media, timestamps, and source-post context.
  • X Post Replies API — Collect public replies from X post URLs with selectable ordering, reply text, authors, visible engagement, media, and parent-post context.
  • Twitter Mentions API — Collect public posts mentioning a specified account.
  • Twitter Media Scraper API — Collect an account's photo, video and GIF posts with full-quality media files.

Explore other platforms

Combine X data with public data from other supported social platforms.

Twitter Video Transcript API — FAQ

Twitter Video Transcript API is a programmatic interface for turning the speech in X videos into text, from the URLs of the posts that contain them. It returns a plain-text transcript and the video's duration in seconds for each video.

Copy the post's link, add it to urls, which accepts several links per request, and read the transcript from text once the task succeeds.

No. Each video returns one plain-text transcript with format "text" and the video's total duration_seconds; there are no per-line timings.

The Twitter Video Transcript API charges 0.7 credits for a video up to 2 minutes. Longer videos cost 4 credits for every started minute of their full length, so a 3-minute video costs 12 credits.

The transcript is written in the language spoken in the video. The result carries no language label, so detect it from text if your workflow needs one.

Posts without a video return no row and are not charged. When none of the submitted posts has a video, the task fails and is fully refunded.