---
title: "TikTok Video Metadata"
method: POST
path: "/tiktok/video/metadata"
---

# TikTok Video Metadata

`POST /tiktok/video/metadata`

Get TikTok video metadata.

## Request body

- object
  - `video_url` string, required — The TikTok video URL
  - `channel` 'apify' | 'rapid' | 'memories.ai', required — The channel name. Supported values: apify, rapid, memories.ai

## Response `200`

Video metadata information with detailed TikTok data

- object
  - `code` string — Response code indicating the result status
  - `msg` string — Response message describing the operation result
  - `data` object[] — Array containing TikTok video metadata objects
    - `id` string — Video ID
    - `text` string — Video caption/text
    - `textLanguage` string — Language of the video text
    - `createTime` number — Creation timestamp
    - `createTimeISO` string — Creation time in ISO format
    - `locationCreated` string — Location where the video was created
    - `isAd` boolean — Whether the video is an advertisement
    - `authorMeta` object — Author/user metadata
      - `id` string
      - `name` string — Author username
      - `profileUrl` string
      - `nickName` string — Author display name
      - `verified` boolean — Whether the author is verified
      - `avatar` string — Avatar URL
      - `following` number — Number of users the author follows
      - `fans` number — Number of followers
      - `heart` number — Total likes received
      - `video` number — Number of videos posted
      - `digg` number — Total diggs
    - `musicMeta` object — Music metadata
      - `musicName` string — Music name
      - `musicAuthor` string — Music author
      - `musicOriginal` boolean — Whether it's original audio
      - `playUrl` string — Music playback URL
      - `coverMediumUrl` string — Cover image URL
      - `musicId` string — Music ID
    - `webVideoUrl` string — TikTok web video URL
    - `mediaUrls` string[] — Array of media URLs
    - `videoMeta` object — Video metadata
      - `height` number — Video height in pixels
      - `width` number — Video width in pixels
      - `duration` number — Video duration in seconds
      - `coverUrl` string — Cover image URL
      - `originalCoverUrl` string — Original cover image URL
      - `definition` string — Video definition
      - `format` string — Video format
      - `subtitleLinks` object[] — Array of subtitle links with language information
        - `language` string — Subtitle language code
        - `downloadLink` string — Subtitle download link
        - `tiktokLink` string — TikTok subtitle link
        - `source` string — Subtitle source
        - `sourceUnabbreviated` string — Full subtitle source name
        - `version` string — Subtitle version
      - `downloadAddr` string — Video download address
    - `diggCount` number — Number of likes
    - `shareCount` number — Number of shares
    - `playCount` number — Number of plays
    - `collectCount` number — Number of collections
    - `commentCount` number — Number of comments
    - `repostCount` number — Number of reposts
    - `mentions` string[] — Array of mentions
    - `detailedMentions` object[] — Array of detailed mentions
    - `hashtags` string[] — Array of hashtags
    - `effectStickers` object[] — Array of effect stickers
    - `isSlideshow` boolean — Whether the video is a slideshow
    - `isPinned` boolean — Whether the video is pinned
    - `isSponsored` boolean — Whether the video is sponsored
    - `submittedVideoUrl` string — Submitted video URL
  - `success` boolean — Indicates whether the operation was successful
  - `failed` boolean — Indicates whether the operation failed

---

[API](https://skmtc.net/memories/apis/screenplay-extraction-api.md) · [All operations](https://skmtc.net/memories/apis/screenplay-extraction-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/memories/screenplay-extraction-api/versions/720c8c144ddc/schema)