Skip to main content
POST
Twitter Video Transcript API

Twitter Video Transcript

Turn the speech in an X video into text. Pass the link of a post that contains a video and get back the transcript as plain text together with the video’s length in seconds. Transcripts make video content searchable and quotable: pull the exact wording of an interview clip, summarize a product demo, translate a speech, or feed spoken content into the same analysis you already run on written posts.
Provide X post URLs that contain a video in urls, using //status/. Each video returns its spoken text and duration. A video up to 2 minutes costs 0.7 credits; a longer video costs 4 credits for every started minute of its full length, so a 3-minute video costs 12 credits. Posts without a video return no row and are not charged.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Provide X post URLs that contain a video in urls, using /{username}/status/{post_id}. Each video returns its spoken text and duration.

urls
string[]
required

Public profile or content URLs.

Minimum array length: 1
Minimum string length: 1
callback_url
string<uri>

Response

Task accepted

code
integer
data
object