GET /api/v1/x/tweets/{id}/subtitles

Tweets

Changed on Oct 20, 2026

Returns the caption tracks of 1 public tweet's videos, as X's player reads them. Each track has its language, name, timed cues, and full text. A tweet without video, or a video without captions, returns no track and costs nothing.

get/api/v1/x/tweets/{id}/subtitles

Request

Base URL: https://xquik.com
URL: https://xquik.com/api/v1/x/tweets/{id}/subtitles
Auth: one of:
- API key in header x-api-key
- HTTP bearer
- none

Path parameters

idstring required

Tweet ID or URL-encoded tweet URL, such as x.com/nasa/status/20. Takes x.com & twitter.com links with or without https://, www., mobile., a query or a fragment, & /i/status or /i/web/status links. Anything else gets 400 invalid_tweet_id.

Query parameters

fieldsstring

Example:id,text,author.username

Fields to keep in each row, comma-separated. Use dots for nested fields, such as author.username. A list keeps the field in each item. Case & underscores do not matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics always stay. An unknown name answers 400 unknown_field with the valid names, before any read. The price stays the same. SDK row types then hold only the named fields. A longer URL fails at the edge before Xquik reads it.

omitstring

Example:entities,media

Fields to drop from each row, comma-separated. It takes the same names as fields. With fields, it drops from the kept fields. A longer URL fails at the edge before Xquik reads it.

Response

Caption tracks of the tweet's videos

Example response

{
  "subtitles": {
    "tweetId": "2104593672624886205",
    "tracks": [
      {
        "mediaKey": "13_2104593621043314689",
        "language": "en",
        "name": "Planetary Defenders_Caption.en_US.srt",
        "autoGenerated": false,
        "url": "https://video.twimg.com/subtitles/amplify_video/2104593621043314689/0/-FdxBBY2iGcoP5wb.vtt",
        "text": "This asteroid 2024 YR4 might get interesting.",
        "truncated": false,
        "cues": [
          {
            "startMs": 0,
            "endMs": 3370,
            "text": "This asteroid\n2024 YR4 might get interesting."
          }
        ]
      }
    ]
  }
}

Changes

Oct 20, 202645942c75fdc2 Revision changes
- warning
  added the new topup_in_progress enum value to the ///// response property for the response status
- warning
  added the new topup_in_progress enum value to the ////// response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the ////// response property for the response status
- warning
  added the new topup_in_progress enum value to the /////// response property for the response status
- warning
  added the new topup_in_progress enum value to the ////// response property for the response status
- warning
  added the new topup_in_progress enum value to the /////// response property for the response status

Operation history