> ## Documentation Index
> Fetch the complete documentation index at: https://api-tools.memories.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# TikTok Video Metadata
> Get TikTok video metadata.
**Product**: Visual Intelligence — Social Media Scraping
**Use case**: Fetch video metadata, transcripts, captions, and comments from YouTube, Instagram, TikTok, and Twitter/X
**Host**: `https://mavi-backend.memories.ai/serve/api/v2`
**Auth**: `Authorization: sk-mavi-...` (no `Bearer` prefix)
This endpoint allows you to retrieve metadata for a TikTok video.
Channel routing guide: see [Social Media Scraping Overview](/visual-intelligence/social-media-scraping-overview). Endpoints with a `channel` request field let you choose `apify`, `rapid`, or `memories.ai`; endpoints without this field use managed routing.
**Pricing:**
* **rapid** channel: \$0.02 per video
* **memories.ai** channel: \$0.01 per video
* **apify** channel: Charged at Apify's actual cost (higher and variable pricing)
### Code Example
```python Python theme={null}
import requests
BASE_URL = "https://mavi-backend.memories.ai/serve/api/v2"
API_KEY = "sk-mavi-..."
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
| Field | Type | Required | Description |
| ---------- | ------ | -------- | ------------------------------------------------------------------- |
| video\_url | string | Yes | The TikTok video URL |
| channel | string | Yes | The channel name. Supported values: `apify`, `rapid`, `memories.ai` |
### Response
**Response shape depends on the `channel` parameter** — same channel-dependent split as the YouTube endpoints. Verified live:
* `channel: "apify"` — `data` is an **array** of flat objects with the rich TikTok-specific fields documented below (`authorMeta`, `musicMeta`, `videoMeta`, `diggCount`, etc.).
* `channel: "memories.ai"` — `data` is an **object** in TikTok's native shape: `{ itemInfo, shareMeta, statusCode, statusMsg }`. Different nesting and field names.
* `channel: "rapid"` — same alternative shape as `memories.ai`.
The example and Response Parameters table below describe the **apify** shape. Pick a channel per integration and stick to it.
```json theme={null}
{
"code": 200,
"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
| Parameter | Type | Description |
| ------------------------------- | -------------- | ------------------------------------------------- |
| code | string | Response code indicating the result status |
| msg | string | Response message describing the operation result |
| data | array\[object] | Array containing TikTok video metadata objects |
| data\[].id | string | Video ID |
| data\[].text | string | Video caption/text |
| data\[].textLanguage | string | Language of the video text |
| data\[].createTime | number | Creation timestamp |
| data\[].createTimeISO | string | Creation time in ISO format |
| data\[].locationCreated | string | Location where the video was created |
| data\[].isAd | boolean | Whether the video is an advertisement |
| data\[].authorMeta | object | Author/user metadata |
| data\[].authorMeta.name | string | Author username |
| data\[].authorMeta.nickName | string | Author display name |
| data\[].authorMeta.verified | boolean | Whether the author is verified |
| data\[].authorMeta.following | number | Number of users the author follows |
| data\[].authorMeta.fans | number | Number of followers |
| data\[].authorMeta.heart | number | Total likes received |
| data\[].authorMeta.video | number | Number of videos posted |
| data\[].musicMeta | object | Music metadata |
| data\[].musicMeta.musicName | string | Music name |
| data\[].musicMeta.musicAuthor | string | Music author |
| data\[].musicMeta.musicOriginal | boolean | Whether it's original audio |
| data\[].musicMeta.playUrl | string | Music playback URL |
| data\[].musicMeta.musicId | string | Music ID |
| data\[].webVideoUrl | string | TikTok web video URL |
| data\[].mediaUrls | array\[string] | Array of media URLs |
| data\[].videoMeta | object | Video metadata |
| data\[].videoMeta.height | number | Video height in pixels |
| data\[].videoMeta.width | number | Video width in pixels |
| data\[].videoMeta.duration | number | Video duration in seconds |
| data\[].videoMeta.coverUrl | string | Cover image URL |
| data\[].videoMeta.definition | string | Video definition (e.g., "540p") |
| data\[].videoMeta.format | string | Video format (e.g., "mp4") |
| data\[].videoMeta.subtitleLinks | array\[object] | Array of subtitle links with language information |
| data\[].videoMeta.downloadAddr | string | Video download address |
| data\[].diggCount | number | Number of likes |
| data\[].shareCount | number | Number of shares |
| data\[].playCount | number | Number of plays |
| data\[].collectCount | number | Number of collections |
| data\[].commentCount | number | Number of comments |
| data\[].repostCount | number | Number of reposts |
| data\[].isSlideshow | boolean | Whether the video is a slideshow |
| data\[].isPinned | boolean | Whether the video is pinned |
| data\[].isSponsored | boolean | Whether the video is sponsored |
| success | boolean | Indicates whether the operation was successful |
| failed | boolean | Indicates whether the operation failed |
## OpenAPI
````yaml POST /tiktok/video/metadata
openapi: 3.1.0
info:
title: Video Metadata & Transcript API Reference
description: >-
REST APIs for retrieving video metadata and transcripts from YouTube,
Instagram, TikTok, and Twitter
version: v1.0.1
servers:
- url: https://mavi-backend.memories.ai/serve/api/v2
security:
- ApiKeyAuth: []
paths:
/tiktok/video/metadata:
post:
summary: TikTok Video Metadata
description: Get TikTok video metadata.
operationId: tiktok_video_metadata
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
video_url:
type: string
description: The TikTok video URL
example: https://www.tiktok.com/@cutshall73/video/7543017294226558221
channel:
type: string
description: >-
The channel name. Supported values: apify, rapid,
memories.ai
enum:
- apify
- rapid
- memories.ai
example: apify
required:
- video_url
- channel
responses:
'200':
description: Video metadata information with detailed TikTok data
content:
application/json:
schema:
type: object
properties:
code:
type: string
example: 200
description: Response code indicating the result status
msg:
type: string
example: success
description: Response message describing the operation result
data:
type: array
items:
type: object
properties:
id:
type: string
example: '7543017294226558221'
description: Video ID
text:
type: string
example: OOTD and confirmation Reacher is alive 🧸🏼
description: Video caption/text
textLanguage:
type: string
example: en
description: Language of the video text
createTime:
type: number
example: 1756245606
description: Creation timestamp
createTimeISO:
type: string
example: '2025-08-26T22:00:06.000Z'
description: Creation time in ISO format
locationCreated:
type: string
example: US
description: Location where the video was created
isAd:
type: boolean
example: true
description: Whether the video is an advertisement
authorMeta:
type: object
description: Author/user metadata
properties:
id:
type: string
example: '6638037497953681414'
name:
type: string
example: cutshall73
description: Author username
profileUrl:
type: string
example: https://www.tiktok.com/@cutshall73
nickName:
type: string
example: Whitney Lee Cutshall
description: Author display name
verified:
type: boolean
example: false
description: Whether the author is verified
avatar:
type: string
example: >-
https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/...
description: Avatar URL
following:
type: number
example: 5835
description: Number of users the author follows
fans:
type: number
example: 3908
description: Number of followers
heart:
type: number
example: 3600000
description: Total likes received
video:
type: number
example: 76
description: Number of videos posted
digg:
type: number
example: 33000
description: Total diggs
musicMeta:
type: object
description: Music metadata
properties:
musicName:
type: string
example: original sound
description: Music name
musicAuthor:
type: string
example: Whitney Lee Cutshall
description: Music author
musicOriginal:
type: boolean
example: true
description: Whether it's original audio
playUrl:
type: string
example: >-
https://v16m.tiktokcdn-us.com/401d56406f99341037e41da12523731a/...
description: Music playback URL
coverMediumUrl:
type: string
example: >-
https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/...
description: Cover image URL
musicId:
type: string
example: '7543017437262023437'
description: Music ID
webVideoUrl:
type: string
example: >-
https://www.tiktok.com/@cutshall73/video/7543017294226558221
description: TikTok web video URL
mediaUrls:
type: array
items:
type: string
example:
- >-
https://api.apify.com/v2/key-value-stores/YvBVzx9NfbVwyqE45/records/video-cutshall73-20250826220006-7543017294226558221.mp4
description: Array of media URLs
videoMeta:
type: object
description: Video metadata
properties:
height:
type: number
example: 1024
description: Video height in pixels
width:
type: number
example: 576
description: Video width in pixels
duration:
type: number
example: 36
description: Video duration in seconds
coverUrl:
type: string
example: >-
https://api.apify.com/v2/key-value-stores/YvBVzx9NfbVwyqE45/records/cover-cutshall73-20250826220006-7543017294226558221.jpg
description: Cover image URL
originalCoverUrl:
type: string
example: >-
https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/...
description: Original cover image URL
definition:
type: string
example: 540p
description: Video definition
format:
type: string
example: mp4
description: Video format
subtitleLinks:
type: array
items:
type: object
properties:
language:
type: string
example: eng-US
description: Subtitle language code
downloadLink:
type: string
example: >-
https://v16m-webapp.tiktokcdn-us.com/2c1ed634ee265bbff4a38111e7511061/...
description: Subtitle download link
tiktokLink:
type: string
example: >-
https://v16m-webapp.tiktokcdn-us.com/2c1ed634ee265bbff4a38111e7511061/...
description: TikTok subtitle link
source:
type: string
example: ASR
description: Subtitle source
sourceUnabbreviated:
type: string
example: automatic speech recognition
description: Full subtitle source name
version:
type: string
example: 1:big_caption
description: Subtitle version
description: >-
Array of subtitle links with language
information
downloadAddr:
type: string
example: >-
https://api.apify.com/v2/key-value-stores/YvBVzx9NfbVwyqE45/records/video-cutshall73-20250826220006-7543017294226558221.mp4
description: Video download address
diggCount:
type: number
example: 507
description: Number of likes
shareCount:
type: number
example: 2
description: Number of shares
playCount:
type: number
example: 20200
description: Number of plays
collectCount:
type: number
example: 3
description: Number of collections
commentCount:
type: number
example: 6
description: Number of comments
repostCount:
type: number
example: 0
description: Number of reposts
mentions:
type: array
items:
type: string
description: Array of mentions
detailedMentions:
type: array
items:
type: object
description: Array of detailed mentions
hashtags:
type: array
items:
type: string
description: Array of hashtags
effectStickers:
type: array
items:
type: object
description: Array of effect stickers
isSlideshow:
type: boolean
example: false
description: Whether the video is a slideshow
isPinned:
type: boolean
example: false
description: Whether the video is pinned
isSponsored:
type: boolean
example: false
description: Whether the video is sponsored
submittedVideoUrl:
type: string
example: >-
https://www.tiktok.com/@cutshall73/video/7543017294226558221
description: Submitted video URL
description: Array containing TikTok video metadata objects
success:
type: boolean
example: true
description: Indicates whether the operation was successful
failed:
type: boolean
example: false
description: Indicates whether the operation failed
components:
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: Authorization
````