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
| Parameters | Required | Description |
|---|---|---|
urls | Required | One 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.
- POST {"urls": ["https://x.com/NASA/status/2119833829389041896"]} to /v1/x/post-transcript.
- Poll GET /v1/tasks/{task_id}; transcripts are ready once status is succeeded.
- 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.
Related APIs
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.
- Twitter Profile Scraper API
- Twitter Search API
- X Followers List API
- X Following List API
- X Post Retweeters API
- X Trends API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Thread Context API
- X Account Location API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- X User Replies API
- Twitter Follow Checker API