---
title: "Get Drama Detail"
method: GET
path: "/api/drama/detail"
tags: ["Drama"]
---

# Get Drama Detail

`GET /api/drama/detail`

## Request

- Base URL: `https://tiktok-api23.p.rapidapi.com`
- URL: `https://tiktok-api23.p.rapidapi.com/api/drama/detail`
- Auth: API key in header `x-rapidapi-key`

Get Drama Detail

## Query parameters

- `dramaId` string, required: Drama ID

## Response `200`

Success

- object
  - `dramaInfo` object
    - `AIGCDescription` string: AI-generated description of the video, if available
    - `CategoryType` number: Indicates the video category type defined by TikTok
    - `IsHDBitrate` boolean
    - `ShowAIGC` boolean
    - `author` object
      - `avatarLarger` string: URL of the user’s large-size avatar image
      - `avatarMedium` string: URL of the user’s medium-size avatar image
      - `avatarThumb` string: URL of the user’s thumbnail-size avatar image
      - `commentSetting` number: User’s comment privacy setting for their posts
      - `downloadSetting` number: User’s download permission setting for their videos
      - `duetSetting` number: User’s duet permission setting
      - `ftc` boolean: Indicates whether the account is subject to child safety restrictions
      - `id` string: User ID
      - `isADVirtual` boolean: Indicates whether the account is a virtual or advertisement related profile
      - `nickname` string: The user’s profile display name
      - `openFavorite` boolean: Whether the user’s liked videos list is public
      - `privateAccount` boolean: Indicates whether the account is set to private
      - `secUid` string: User secUid
      - `secret` boolean: Indicates whether the account is set to private
      - `signature` string: The user’s profile bio
      - `stitchSetting` number: User’s Stitch permission setting
      - `uniqueId` string: User uniqueID. The user’s public TikTok handle (username)
      - `verified` boolean: Indicates whether the account is officially verified
    - `authorStats` object: User stats
      - `diggCount` number: Total number of likes the user has given to other videos
      - `followerCount` number: Total number of users following this account
      - `followingCount` number: Number of accounts this user is following
      - `friendCount` number: Number of mutual followers (users that this account follows and who also follow back)
      - `heart` number: Total number of likes the user has received across all videos
      - `heartCount` number: Same as "heart". Represents the total number of likes the user has received
      - `videoCount` number: Total number of videos the user has posted
    - `authorStatsV2` object: An enhanced version of user stats where all metrics are exact values (not rounded)
      - `diggCount` string: Total number of likes the user has given to other videos
      - `followerCount` string: Total number of users following this account
      - `followingCount` string: Number of accounts this user is following
      - `friendCount` string: Number of mutual followers (users that this account follows and who also follow back)
      - `heart` string: Total number of likes the user has received across all videos
      - `heartCount` string: Same as "heart". Represents the total number of likes the user has received
      - `videoCount` string: Total number of videos the user has posted
    - `backendSourceEventTracking` string: Internal backend event tracking identifier used by TikTok
    - `contents` object[]
      - `desc` string: The text description of the video
    - `createTime` number: Create time of the drama (timestamp)
    - `creatorAIComment` object
      - `eligibleVideo` boolean: Indicates whether the video is eligible for AI-powered comments
      - `hasAITopic` boolean: Indicates whether the video contains AI-generated topics
      - `notEligibleReason` number: Reason code explaining why the video is not eligible for AI comments
    - `desc` string: The text description of the video
    - `diversificationId` number: Identifier used by TikTok to diversify video distribution
    - `dramaInfo` object
      - `authorUID` string: The unique identifier of the user who created the drama
      - `cover` object
        - `urlList` string[]: A list of URLs for the drama cover images
      - `description` string: The description of the drama
      - `dramaID` string: The unique identifier of the drama
      - `dramaName` string: The name of the drama
      - `isLimitedFree` boolean: Whether the drama has limited free access
      - `numVideos` number: The total number of episodes in the drama
      - `numWatched` string: The number of times the drama has been watched
      - `themes` object[]: The themes associated with the drama
        - `tagID` string: The unique identifier of the drama theme
        - `tagKey` string: The key identifying the drama theme
        - `tagVal` string: The display value of the drama theme
      - `totalDuration` string: The total duration of all episodes in the drama, in seconds
      - `zoomCover` object
        - `240` string
        - `480` string
        - `720` string
        - `960` string
    - `duetDisplay` number: Indicates duet visibility settings for this video
    - `forFriend` boolean: Indicates whether the video is shared only with friends
    - `id` string: Video ID
    - `isAd` boolean: Indicates whether the video is an advertisement
    - `isReviewing` boolean: Indicates whether the video is still under TikTok review
    - `itemCommentStatus` number: The comment status of the video
    - `item_control` object
      - `can_repost` boolean: Indicates whether the video can be reposted by users
    - `officalItem` boolean: Indicates whether the video is marked as official content
    - `originalItem` boolean: Indicates whether this is original content by the creator
    - `privateItem` boolean: Indicates whether the video is set to private
    - `secret` boolean: Indicates whether the video is set to private
    - `shareEnabled` boolean: Indicates whether sharing is enabled for this video
    - `stats` object
      - `collectCount` number: Number of times the post has been saved
      - `commentCount` number: Total number of comments on the post
      - `diggCount` number: Total number of likes the post has received
      - `playCount` number: Total number of views the post has generated
      - `shareCount` number: Number of times the post has been shared
    - `statsV2` object
      - `collectCount` string: Number of times the post has been saved
      - `commentCount` string: Total number of comments on the post
      - `diggCount` string: Total number of likes the post has received
      - `playCount` string: Total number of views the post has generated
      - `repostCount` string: Number of times the post has been reposted
      - `shareCount` string: Number of times the post has been shared
    - `stitchDisplay` number: Indicates stitch visibility settings for this video
    - `stitchEnabled` boolean: Indicates whether stitching is allowed for this video
    - `textLanguage` string: Detected language of the caption text
    - `textTranslatable` boolean: Indicates whether the caption text can be translated
    - `video` object
      - `cover` string: URL of the primary video thumbnail
      - `duration` number: Video duration in seconds
      - `dynamicCover` string: URL of the animated video cover (dynamic thumbnail)
      - `height` number: Video height in pixels
      - `id` string: Drama ID
      - `originCover` string: URL of the original (unprocessed) video thumbnail
      - `ratio` string: Video resolution ratio label
      - `volumeInfo` object
        - `Loudness` number: Measured loudness level of the audio track
        - `Peak` number: Peak volume value detected in the audio
      - `width` number: Video height in pixels
      - `zoomCover` object
        - `240` string
        - `480` string
        - `720` string
        - `960` string
  - `totalEpisodeCount` string: The total number of episodes in the drama

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Not Found
- `500`: Internal Server Error

## Changes

- **2026-11-03** `095fffd2c728`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tikfly/apis/tikfly-api-unoffical-tiktok-api/changes/api/drama/detail/get.md)

---

[API](https://skmtc.dev/tikfly/apis/tikfly-api-unoffical-tiktok-api.md) - [All operations](https://skmtc.dev/tikfly/apis/tikfly-api-unoffical-tiktok-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tikfly/apis/tikfly-api-unoffical-tiktok-api/revisions/095fffd2c728?raw)
