POST
/
tiktok
/
video
/
metadata
TikTok Video Metadata
curl --request POST \
  --url https://mavi-backend.memories.ai/serve/api/v2/tiktok/video/metadata \
  --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": [
    {
      "id": "7543017294226558221",
      "text": "OOTD and confirmation Reacher is alive 🧸🏼",
      "textLanguage": "en",
      "createTime": 1756245606,
      "createTimeISO": "2025-08-26T22:00:06.000Z",
      "locationCreated": "US",
      "isAd": true,
      "authorMeta": {
        "id": "6638037497953681414",
        "name": "cutshall73",
        "profileUrl": "https://www.tiktok.com/@cutshall73",
        "nickName": "Whitney Lee Cutshall",
        "verified": false,
        "avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/...",
        "following": 5835,
        "fans": 3908,
        "heart": 3600000,
        "video": 76,
        "digg": 33000
      },
      "musicMeta": {
        "musicName": "original sound",
        "musicAuthor": "Whitney Lee Cutshall",
        "musicOriginal": true,
        "playUrl": "https://v16m.tiktokcdn-us.com/401d56406f99341037e41da12523731a/...",
        "coverMediumUrl": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/...",
        "musicId": "7543017437262023437"
      },
      "webVideoUrl": "https://www.tiktok.com/@cutshall73/video/7543017294226558221",
      "mediaUrls": [
        "https://api.apify.com/v2/key-value-stores/YvBVzx9NfbVwyqE45/records/video-cutshall73-20250826220006-7543017294226558221.mp4"
      ],
      "videoMeta": {
        "height": 1024,
        "width": 576,
        "duration": 36,
        "coverUrl": "https://api.apify.com/v2/key-value-stores/YvBVzx9NfbVwyqE45/records/cover-cutshall73-20250826220006-7543017294226558221.jpg",
        "originalCoverUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/...",
        "definition": "540p",
        "format": "mp4",
        "subtitleLinks": [
          {
            "language": "eng-US",
            "downloadLink": "https://v16m-webapp.tiktokcdn-us.com/2c1ed634ee265bbff4a38111e7511061/...",
            "tiktokLink": "https://v16m-webapp.tiktokcdn-us.com/2c1ed634ee265bbff4a38111e7511061/...",
            "source": "ASR",
            "sourceUnabbreviated": "automatic speech recognition",
            "version": "1:big_caption"
          }
        ],
        "downloadAddr": "https://api.apify.com/v2/key-value-stores/YvBVzx9NfbVwyqE45/records/video-cutshall73-20250826220006-7543017294226558221.mp4"
      },
      "diggCount": 507,
      "shareCount": 2,
      "playCount": 20200,
      "collectCount": 3,
      "commentCount": 6,
      "repostCount": 0,
      "mentions": [],
      "detailedMentions": [],
      "hashtags": [],
      "effectStickers": [],
      "isSlideshow": false,
      "isPinned": false,
      "isSponsored": false,
      "submittedVideoUrl": "https://www.tiktok.com/@cutshall73/video/7543017294226558221"
    }
  ],
  "failed": false,
  "success": true
}
This endpoint allows you to retrieve metadata 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_metadata(video_url: str, channel: str):
    url = f"{BASE_URL}/tiktok/video/metadata"
    data = {"video_url": video_url, "channel": channel}
    resp = requests.post(url, headers=HEADERS, json=data)
    return resp.json()

# Usage example
result = tiktok_video_metadata("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 metadata information with detailed TikTok data. 
{
  "code": "0000",
  "msg": "success",
  "data": [
    {
      "id": "7543017294226558221",
      "text": "OOTD and confirmation Reacher is alive 🧸🏼",
      "textLanguage": "en",
      "createTime": 1756245606,
      "createTimeISO": "2025-08-26T22:00:06.000Z",
      "locationCreated": "US",
      "isAd": true,
      "authorMeta": {
        "id": "6638037497953681414",
        "name": "cutshall73",
        "profileUrl": "https://www.tiktok.com/@cutshall73",
        "nickName": "Whitney Lee Cutshall",
        "verified": false,
        "avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/...",
        "following": 5835,
        "fans": 3908,
        "heart": 3600000,
        "video": 76,
        "digg": 33000
      },
      "musicMeta": {
        "musicName": "original sound",
        "musicAuthor": "Whitney Lee Cutshall",
        "musicOriginal": true,
        "playUrl": "https://v16m.tiktokcdn-us.com/401d56406f99341037e41da12523731a/...",
        "coverMediumUrl": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/...",
        "musicId": "7543017437262023437"
      },
      "webVideoUrl": "https://www.tiktok.com/@cutshall73/video/7543017294226558221",
      "mediaUrls": [
        "https://api.apify.com/v2/key-value-stores/YvBVzx9NfbVwyqE45/records/video-cutshall73-20250826220006-7543017294226558221.mp4"
      ],
      "videoMeta": {
        "height": 1024,
        "width": 576,
        "duration": 36,
        "coverUrl": "https://api.apify.com/v2/key-value-stores/YvBVzx9NfbVwyqE45/records/cover-cutshall73-20250826220006-7543017294226558221.jpg",
        "originalCoverUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/...",
        "definition": "540p",
        "format": "mp4",
        "subtitleLinks": [
          {
            "language": "eng-US",
            "downloadLink": "https://v16m-webapp.tiktokcdn-us.com/2c1ed634ee265bbff4a38111e7511061/...",
            "tiktokLink": "https://v16m-webapp.tiktokcdn-us.com/2c1ed634ee265bbff4a38111e7511061/...",
            "source": "ASR",
            "sourceUnabbreviated": "automatic speech recognition",
            "version": "1:big_caption"
          }
        ],
        "downloadAddr": "https://api.apify.com/v2/key-value-stores/YvBVzx9NfbVwyqE45/records/video-cutshall73-20250826220006-7543017294226558221.mp4"
      },
      "diggCount": 507,
      "shareCount": 2,
      "playCount": 20200,
      "collectCount": 3,
      "commentCount": 6,
      "repostCount": 0,
      "mentions": [],
      "detailedMentions": [],
      "hashtags": [],
      "effectStickers": [],
      "isSlideshow": false,
      "isPinned": false,
      "isSponsored": false,
      "submittedVideoUrl": "https://www.tiktok.com/@cutshall73/video/7543017294226558221"
    }
  ],
  "failed": false,
  "success": true
}

​
Response Parameters

ParameterTypeDescription
codestringResponse code indicating the result status
msgstringResponse message describing the operation result
dataarray[object]Array containing TikTok video metadata objects
data[].idstringVideo ID
data[].textstringVideo caption/text
data[].textLanguagestringLanguage of the video text
data[].createTimenumberCreation timestamp
data[].createTimeISOstringCreation time in ISO format
data[].locationCreatedstringLocation where the video was created
data[].isAdbooleanWhether the video is an advertisement
data[].authorMetaobjectAuthor/user metadata
data[].authorMeta.namestringAuthor username
data[].authorMeta.nickNamestringAuthor display name
data[].authorMeta.verifiedbooleanWhether the author is verified
data[].authorMeta.followingnumberNumber of users the author follows
data[].authorMeta.fansnumberNumber of followers
data[].authorMeta.heartnumberTotal likes received
data[].authorMeta.videonumberNumber of videos posted
data[].musicMetaobjectMusic metadata
data[].musicMeta.musicNamestringMusic name
data[].musicMeta.musicAuthorstringMusic author
data[].musicMeta.musicOriginalbooleanWhether it’s original audio
data[].musicMeta.playUrlstringMusic playback URL
data[].musicMeta.musicIdstringMusic ID
data[].webVideoUrlstringTikTok web video URL
data[].mediaUrlsarray[string]Array of media URLs
data[].videoMetaobjectVideo metadata
data[].videoMeta.heightnumberVideo height in pixels
data[].videoMeta.widthnumberVideo width in pixels
data[].videoMeta.durationnumberVideo duration in seconds
data[].videoMeta.coverUrlstringCover image URL
data[].videoMeta.definitionstringVideo definition (e.g., “540p”)
data[].videoMeta.formatstringVideo format (e.g., “mp4”)
data[].videoMeta.subtitleLinksarray[object]Array of subtitle links with language information
data[].videoMeta.downloadAddrstringVideo download address
data[].diggCountnumberNumber of likes
data[].shareCountnumberNumber of shares
data[].playCountnumberNumber of plays
data[].collectCountnumberNumber of collections
data[].commentCountnumberNumber of comments
data[].repostCountnumberNumber of reposts
data[].isSlideshowbooleanWhether the video is a slideshow
data[].isPinnedbooleanWhether the video is pinned
data[].isSponsoredbooleanWhether the video is sponsored
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 metadata information with detailed TikTok data

​
code
string

Response code indicating the result status

Example:

"0000"

​
msg
string

Response message describing the operation result

Example:

"success"

​
data
object[]

Array containing TikTok video metadata objects

​
success
boolean

Indicates whether the operation was successful

Example:

true

​
failed
boolean

Indicates whether the operation failed

Example:

false