POST
/
tiktok
/
video
/
transcript
TikTok Video Transcript
curl --request POST \
  --url https://mavi-backend.memories.ai/serve/api/v2/tiktok/video/transcript \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "video_url": "https://www.tiktok.com/@cutshall73/video/7543017294226558221",
  "channel": "apify"
}
'
{
  "code": "0000",
  "msg": "success",
  "data": [
    {
      "credits_remaining": "9997665621",
      "id": "7543017294226558221",
      "url": "https://www.tiktok.com/@cutshall73/video/7543017294226558221",
      "transcript": "WEBVTT\n\n\n00:00:00.140 --> 00:00:01.600\nSay hi. Hi.\n\n00:00:01.700 --> 00:00:03.560\nSay. Say I'm alive.\n\n00:00:03.660 --> 00:00:06.280\nI'm alive. We're gonna do a little OOTD.\n\n00:00:07.460 --> 00:00:09.380\nI've got on my pretty,\n\n00:00:09.381 --> 00:00:14.401\ncute little cheetah print dress I got from my friend on Facebook.\n\n00:00:16.780 --> 00:00:18.460\nHair up in a clip. It's brush.\n\n00:00:18.461 --> 00:00:21.281\nNo makeup because I'm tired.\n\n00:00:21.580 --> 00:00:23.640\nI'm tired. Are you tired?\n\n00:00:24.140 --> 00:00:25.360\nSay, I'm alive.\n\n00:00:25.380 --> 00:00:27.480\nI'm alive! And I'm crazy.\n\n00:00:27.500 --> 00:00:28.300\nI'm crazy.\n\n00:00:28.820 --> 00:00:30.920\nSay bye. Bye.\n\n00:00:31.180 --> 00:00:31.980\nMwah! Mwah.\n\n00:00:32.660 --> 00:00:33.720\nSay hi, river.\n\n00:00:33.860 --> 00:00:35.280\nYou showing your lip gloss?\n"
    }
  ],
  "failed": false,
  "success": true
}
This endpoint allows you to retrieve transcript for a TikTok video.

​
Code Example

import requests

BASE_URL = "https://mavi-backend.memories.ai/serve/api/v2"
API_KEY = "sk-8483027fe3abfe535f6ae01a9979b4f7"
HEADERS = {
    "Authorization": f"{API_KEY}"
}

def tiktok_video_transcript(video_url: str, channel: str):
    url = f"{BASE_URL}/tiktok/video/transcript"
    data = {"video_url": video_url, "channel": channel}
    resp = requests.post(url, headers=HEADERS, json=data)
    return resp.json()

# Usage example
result = tiktok_video_transcript("https://www.tiktok.com/@cutshall73/video/7543017294226558221", "apify")
print(result)

​
Request Body

FieldTypeRequiredDescription
video_urlstringYesThe TikTok video URL
channelstringYesThe channel name. Supported values: apify, rapid, memories.ai

​
Response

Returns the video transcript in WEBVTT format. 
{
  "code": "0000",
  "msg": "success",
  "data": [
    {
      "credits_remaining": "9997665621",
      "id": "7543017294226558221",
      "url": "https://www.tiktok.com/@cutshall73/video/7543017294226558221",
      "transcript": "WEBVTT\n\n\n00:00:00.140 --> 00:00:01.600\nSay hi. Hi.\n\n00:00:01.700 --> 00:00:03.560\nSay. Say I'm alive.\n\n00:00:03.660 --> 00:00:06.280\nI'm alive. We're gonna do a little OOTD.\n\n00:00:07.460 --> 00:00:09.380\nI've got on my pretty,\n\n00:00:09.381 --> 00:00:14.401\ncute little cheetah print dress I got from my friend on Facebook.\n\n00:00:16.780 --> 00:00:18.460\nHair up in a clip. It's brush.\n\n00:00:18.461 --> 00:00:21.281\nNo makeup because I'm tired.\n\n00:00:21.580 --> 00:00:23.640\nI'm tired. Are you tired?\n\n00:00:24.140 --> 00:00:25.360\nSay, I'm alive.\n\n00:00:25.380 --> 00:00:27.480\nI'm alive! And I'm crazy.\n\n00:00:27.500 --> 00:00:28.300\nI'm crazy.\n\n00:00:28.820 --> 00:00:30.920\nSay bye. Bye.\n\n00:00:31.180 --> 00:00:31.980\nMwah! Mwah.\n\n00:00:32.660 --> 00:00:33.720\nSay hi, river.\n\n00:00:33.860 --> 00:00:35.280\nYou showing your lip gloss?\n"
    }
  ],
  "failed": false,
  "success": true
}

​
Response Parameters

ParameterTypeDescription
codestringResponse code indicating the result status
msgstringResponse message describing the operation result
dataarray[object]Array containing transcript data objects
data[].credits_remainingstringRemaining API credits
data[].idstringTikTok video ID
data[].urlstringTikTok video URL
data[].transcriptstringVideo transcript in WEBVTT format with timing information
successbooleanIndicates whether the operation was successful
failedbooleanIndicates whether the operation failed

Authorizations

​
Authorization
string
header
required

Body

application/json
​
video_url
string
required

The TikTok video URL

Example:

"https://www.tiktok.com/@cutshall73/video/7543017294226558221"

​
channel
enum<string>
required

The channel name. Supported values: apify, rapid, memories.ai

Available options:
apify,
rapid,
memories.ai
Example:

"apify"

Response

200 - application/json

Video transcript in WEBVTT format

​
code
string

Response code indicating the result status

Example:

"0000"

​
msg
string

Response message describing the operation result

Example:

"success"

​
data
object[]

Array containing transcript data objects

​
success
boolean

Indicates whether the operation was successful

Example:

true

​
failed
boolean

Indicates whether the operation failed

Example:

false