Skip to main content

​
What it does

Returns the transcript for a video in a specific language. Supports both auto-generated (ASR) and machine-translated subtitles. Returns WebVTT format.

​
Tool details

FieldValue
Tool nametiktok.get_video_transcript
PlatformTikTok
REST endpointGET /v1/tiktok/videos/{videoId}/transcripts/{language}
Result typeDetail tool

​
Parameters

ParameterSourceTypeRequiredDescription
videoIdpathstringYesTikTok video ID
languagepathstringYesBCP47 language code Allowed values: ar-SA, az-AZ, ca-ES, ceb-PH, cs-CZ, da-DK, de-DE, en-US, es-ES, et-EE, fi-FI, fil-PH, fr-FR, ga-IE, he-IL, hr-HR, id-ID, it-IT, ja-JP, ko-KR, lv-LV, lt-LT, ms-MY, nb-NO, nl-NL, pl-PL, pt-PT, ru-RU, sw-SW, sv-SE, th-TH, uk-UA, vi-VN, zh-Hans-CN, zh-Hant-CN.
projection_presetsharedstringNoOptional. Defaults to minimal. Allowed values: full, minimal, identity, engagement, content.
data_fieldssharedstring[]NoOptional. Adds top-level keys from data on top of the selected projection_preset.

​
Example

{
  "name": "tiktok.get_video_transcript",
  "arguments": {
    "videoId": "7526718640041882912",
    "language": "en-US",
    "projection_preset": "minimal",
    "data_fields": [
      "content",
      "url",
      "type",
      "id"
    ]
  }
}

​
Available data fields

[
  "@context",
  "type",
  "id",
  "url",
  "mediaType",
  "language",
  "size",
  "source",
  "content"
]

​
Response notes

Successful calls return a JSON object with a top-level data field and, when available, metadata.creditsUsed and metadata.creditsRemaining. See response format, pagination, and credits.