GET https://xquik.com/api/v1/x/tweets/{id}/subtitles
1 credit when a track comes back · All plans from $0.00012/credit
GET /api/v1/x/tweets/{id}/subtitles.
GET /x/tweets/{id}/subtitles when you need what a tweet’s video says as text.
Each track holds its language, timed cues, and the full text as one line.
A call that returns a track costs 1 credit. A tweet without captions costs nothing.
Build a transcript from the tracks
Readtext for the whole transcript as one line.
Read cues for timed lines, to show beside a player or to cut clips.
A video can hold several tracks, one per language. Pick a track by language.
autoGenerated is true when X transcribed the audio itself.
An uploaded caption file has autoGenerated: false and its file name in name.
A long video splits its captions into files.
Xquik reads the first 50 files of a track. A track with more files gets truncated set to true.
A tweet with no video, or a video without captions, returns "tracks": [].Path parameters
Query parameters
Headers
Response
200 OK
400 Invalid tweet ID
{ "error": "invalid_tweet_id" }
The provided tweet ID is empty or not a valid format.401 Unauthenticated
Missing or invalid API key. Check thex-api-key header value.402 Payment required
Account keys get account options. Guest keys get guest top-up only. No checkout starts automatically. Confirm any payment action.404 Tweet not found
X has no such tweet. The author may have deleted it, or the account is private.502 X API unavailable
The read service returned an error. Retry after a short delay.503 Service busy
X did not serve a caption file in time, or Xquik is busy. Retry after a short delay. The request costs nothing.429 Rate limit exceeded
You exceeded your tier rate limit. Wait for theRetry-After header before retrying.424 Dependency failed
The normalized v1 response contract can return 424 when the read service is unavailable.Tweet subtitles API questions
How do I get the transcript of a Twitter video with an API?
CallGET /x/tweets/{id}/subtitles with the tweet ID or URL.
Read subtitles.tracks[0].text for the transcript.Does it work for videos without uploaded captions?
Yes, when X transcribed the audio itself. Those tracks haveautoGenerated: true.
A video X has no captions for returns no track.Which format are the captions in?
Each cue has a start and an end in milliseconds, and its text.url links to the track’s first WebVTT file on X’s video host.How much does a tweet’s subtitles call cost?
A call that returns at least 1 track costs 1 credit. A tweet without captions costs nothing. A refused or failed request costs nothing.Does Xquik transcribe the audio?
No. Xquik reads the caption tracks X serves with the video.Does this replace X’s official API?
No. This page documents Xquik, an independent third-party service. It does not document X’s official API.Next steps. Get tweet reads the tweet’s fields as JSON. Download media saves its photos and videos.
Response examples
- 400
{ "error": "invalid_input", "message": "Invalid input. Check the request body." } - 401
{ "error": "unauthenticated", "message": "Authentication required." } - 402
{ "error": "insufficient_credits", "message": "Insufficient credits. Top up or subscribe to continue." } - 403
{ "error": "api_key_paused", "message": "This API key is paused. Resume it at dashboard.xquik.com/api-keys to use it again." } - 404
{ "error": "tweet_not_found", "message": "Tweet not found. Check the tweet ID." } - 424
{ "error": "x_api_unavailable", "message": "X data source temporarily unavailable. Try again later." } - 429
{ "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 60 } - 502
{ "error": "x_api_unavailable", "message": "X data source temporarily unavailable. Try again later." } - 503
{ "error": "x_api_unavailable", "message": "Xquik is busy right now. Retry shortly." }