scraper
Back to API docs

Overview

  • Overview

APIs

  • POSTHashtag
  • POSTProduct
  • POSTProduct Reviews
  • POSTTrending Videos
  • POSTUser Profile
  • POSTUser Search
  • POSTVideo Post
  • POSTVideo Transcript
  • POSTVideo Search
  • POSTVideos

TikTok Video Transcript

1 credit

Get the captions and the transcripts of TikTok videos.

POST/api/v1/tools/tiktok/video/transcript

Parameters

videoUrlsstring[]required

Full TikTok video URLs that contain /video/ and the video ID. A URL that gives no video gets an entry in errors. The call fails only when no video is read.

languagesstring[]

Caption languages to keep, such as eng-US. Empty keeps every language.

Response Schema

dataobject

TikTok video transcripts result

videosobject[]

One record for each video that was read, in the order of the request. Each record has the video fields of the Video Post endpoint (videoId, videoUrl, desc, createTime, video, author, stats, music and more), plus the caption fields below.

errorsobject[]

One entry for each URL that gave no video.

metaobject

Request metadata

toolstring

Tool name (tiktok-video-transcript)

creditsUsednumber

Credits consumed (1 for each URL)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/tiktok/video/transcript \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "videoUrls": ["https://www.tiktok.com/@tiktok/video/7340001234567890001"],
    "languages": ["eng-US"]
  }'

Response Example

{
  "data": {
    "videos": [
      {
        "videoId": "7340001234567890001",
        "videoUrl": "https://www.tiktok.com/@tiktok/video/7340001234567890001",
        "inputUrl": "https://www.tiktok.com/@tiktok/video/7340001234567890001",
        "desc": "Three tips for better sleep #health",
        "descLanguage": "en",
        "createTime": "1713945600",
        "hashtags": [
          "health"
        ],
        "captionLanguages": [
          "eng-US"
        ],
        "video": {
          "duration": 41,
          "width": 1080,
          "height": 1920
        },
        "author": {
          "id": "107955",
          "uniqueId": "tiktok",
          "nickname": "TikTok",
          "verified": true
        },
        "stats": {
          "views": 980000,
          "likes": 51000,
          "comments": 830,
          "shares": 2100,
          "saves": 9400,
          "reposts": 0
        },
        "originalLanguage": "eng-US",
        "hasOriginalAudio": true,
        "autoCaptionEnabled": true,
        "subtitles": [
          {
            "languageCode": "eng-US",
            "source": "ASR",
            "version": "1",
            "variant": "default",
            "isAutoGenerated": true,
            "isOriginal": true,
            "content": "WEBVTT\n\n00:00.120 --> 00:02.400\nHere are three tips for better sleep.\n\n00:02.400 --> 00:04.900\nFirst, keep the same bedtime.\n"
          }
        ],
        "transcript": "Here are three tips for better sleep.\nFirst, keep the same bedtime.\n"
      }
    ],
    "errors": [
      {
        "inputUrl": "https://www.tiktok.com/@tiktok/video/7340001234567890002",
        "error": "The video is removed or private.",
        "errorCode": "VIDEO_UNAVAILABLE"
      }
    ]
  },
  "meta": {
    "tool": "tiktok-video-transcript",
    "creditsUsed": 2,
    "requestId": "req_abc123"
  }
}